diff --git a/README.md b/README.md index 22f7f1f..db10bb9 100644 --- a/README.md +++ b/README.md @@ -444,6 +444,7 @@ npx @modelcontextprotocol/inspector 直接参考大家的使用案例:[ShowCase](./examples/README.md) 1. [n8n 完整的教程](./examples/n8n/README.md) +2. [Cherry Studio 完整的教程](./examples/cherrystudio/README.md) ## 小红书 MCP 互助群 diff --git a/README_EN.md b/README_EN.md index a6f8fd5..4d6fb3e 100644 --- a/README_EN.md +++ b/README_EN.md @@ -441,6 +441,7 @@ Use xiaohongshu-mcp for publishing. Refer directly to user cases: [ShowCase](./examples/README.md) 1. [n8n Complete Tutorial](./examples/n8n/README.md) +2. [Cherry Studio Complete Tutorial](./examples/cherrystudio/README.md) ## RedNote MCP Community Group diff --git a/examples/cherrystudio/README.md b/examples/cherrystudio/README.md new file mode 100644 index 0000000..0b983de --- /dev/null +++ b/examples/cherrystudio/README.md @@ -0,0 +1,99 @@ +# Cherry Studio 接入 xiaohongshu-mcp 完整指南 + +## 📋 概述 + +Cherry Studio 是目前最热门的 AI 客户端之一,它简单易用且支持多种开源和闭源大模型。 + +通过 Cherry Studio 调用我们的 xiaohongshu-mcp 服务,您可以使用免费的开源大模型,无需 API key,无需复杂的配置文件,轻松实现小红书内容创作和发布功能。 + +## 🚀 Cherry Studio 安装 + +访问 [Cherry Studio 下载页面](https://www.cherry-ai.com/download) 下载适合您操作系统的安装包,按照提示安装即可。 + +![Cherry Studio 下载页面](./images/cherrystudio-install.png) + + +## 🔌 配置 xiaohongshu-mcp 服务 + +### 步骤 1:启动 xiaohongshu-mcp 服务 + +#### 1.1 登录小红书账号 + +第一次使用需要手动登录,保存小红书的登录状态: + +```bash +# 登录小红书账号 +go run cmd/login/main.go +``` + +#### 1.2 启动 MCP 服务 + +登录成功后,启动 xiaohongshu-mcp 服务: + +```bash +# 默认:无头模式,没有浏览器界面 +go run . + +# 或者:非无头模式,有浏览器界面(调试时使用) +go run . -headless=false +``` + +### 步骤 2:在 Cherry Studio 中添加 MCP 服务器 + +1. **打开 Cherry Studio 设置并添加 MCP 服务器** + - 点击右上角齿轮图标进入设置 + - 选择 "MCP" 标签页 + - 点击 "添加" 按钮 + - 点击 "快速创建" 按钮 + +![cherry-studio-settings](./images/cherrystudio-settings.png) + +2. **配置新的 MCP 服务器** + - 配置以下信息: + * 名称: xiaohongshu-mcp + * 类型: streamableHttp + * URL: http://localhost:18060/mcp + - 点击 "保存" 按钮 + - 点击启用开关 + +![cherry-studio-config](./images/cherrystudio-config.png) + +3. **测试连接** + - 在上一步的配置页面点击 "工具" 按钮 + - 如果链接成功,可以看到所有可用的工具,并且可以选择启用哪些工具 + +![cherry-studio-tools](./images/cherrystudio-tools.png) + +## 🎯 使用指南 + +### 创建新对话并在对话中启用我们的 MCP 工具 + +- 返回首页,点击 "添加助手" +- 选择模型,这里默认使用开源的 GLM-4.5-Flash 模型 +- 点击对话框下的工具 icon,勾选 xiaohongshu-mcp + +![cherry-studio-conversation](./images/cherrystudio-conversation.png) + +### 通过对话使用 MCP 工具 + +Cherry Studio 配合 xiaohongshu-mcp 可以实现多种智能功能: + +* 检查登录状态 + +![cherry-studio-use-1](./images/use-1.png) + +* 小红书站内搜索 + +![cherry-studio-use-2](./images/use-2.png) + +* 发布图文内容 + +![cherry-studio-use-3](./images/use-3.png) + +* 发布成功 + +![cherry-studio-use-4](./images/use-4.png) + +--- + +通过以上配置,您可以在 Cherry Studio 中高效地使用 xiaohongshu-mcp 服务,实现智能化的小红书内容创作和管理! \ No newline at end of file diff --git a/examples/cherrystudio/images/cherrystudio-config.png b/examples/cherrystudio/images/cherrystudio-config.png new file mode 100644 index 0000000..f3e1c35 Binary files /dev/null and b/examples/cherrystudio/images/cherrystudio-config.png differ diff --git a/examples/cherrystudio/images/cherrystudio-conversation.png b/examples/cherrystudio/images/cherrystudio-conversation.png new file mode 100644 index 0000000..4f8c9d9 Binary files /dev/null and b/examples/cherrystudio/images/cherrystudio-conversation.png differ diff --git a/examples/cherrystudio/images/cherrystudio-install.png b/examples/cherrystudio/images/cherrystudio-install.png new file mode 100644 index 0000000..742708d Binary files /dev/null and b/examples/cherrystudio/images/cherrystudio-install.png differ diff --git a/examples/cherrystudio/images/cherrystudio-settings.png b/examples/cherrystudio/images/cherrystudio-settings.png new file mode 100644 index 0000000..0a8a25f Binary files /dev/null and b/examples/cherrystudio/images/cherrystudio-settings.png differ diff --git a/examples/cherrystudio/images/cherrystudio-tools.png b/examples/cherrystudio/images/cherrystudio-tools.png new file mode 100644 index 0000000..4af02d8 Binary files /dev/null and b/examples/cherrystudio/images/cherrystudio-tools.png differ diff --git a/examples/cherrystudio/images/use-1.png b/examples/cherrystudio/images/use-1.png new file mode 100644 index 0000000..6e52bb8 Binary files /dev/null and b/examples/cherrystudio/images/use-1.png differ diff --git a/examples/cherrystudio/images/use-2.png b/examples/cherrystudio/images/use-2.png new file mode 100644 index 0000000..af727bc Binary files /dev/null and b/examples/cherrystudio/images/use-2.png differ diff --git a/examples/cherrystudio/images/use-3.png b/examples/cherrystudio/images/use-3.png new file mode 100644 index 0000000..428518c Binary files /dev/null and b/examples/cherrystudio/images/use-3.png differ diff --git a/examples/cherrystudio/images/use-4.png b/examples/cherrystudio/images/use-4.png new file mode 100644 index 0000000..14c6c09 Binary files /dev/null and b/examples/cherrystudio/images/use-4.png differ