diff --git a/.vscode/mcp.json b/.vscode/mcp.json new file mode 100644 index 0000000..156372e --- /dev/null +++ b/.vscode/mcp.json @@ -0,0 +1,9 @@ +{ + "servers": { + "xiaohongshu-mcp": { + "url": "http://localhost:18060/mcp", + "type": "http" + } + }, + "inputs": [] +} diff --git a/MCP_README.md b/MCP_README.md index 57710cd..3ab2fac 100644 --- a/MCP_README.md +++ b/MCP_README.md @@ -27,35 +27,6 @@ curl -X POST http://localhost:18060/mcp \ ## 📱 客户端接入 -### Claude Desktop - -**重要提示**:Claude Desktop 主要支持 stdio 类型的 MCP 服务器,对于 HTTP 服务器的支持有限。建议使用其他客户端如 VSCode 或 Cursor 来连接 HTTP MCP 服务器。 - -如果要在 Claude Desktop 中使用,需要通过代理的方式: - -在 `~/.config/claude-desktop/claude_desktop_config.json` 中添加: - -```json -{ - "mcpServers": { - "xiaohongshu": { - "command": "curl", - "args": [ - "-X", "POST", - "http://localhost:18060/mcp", - "-H", "Content-Type: application/json", - "-d", "@-" - ], - "env": {} - } - } -} -``` - -**配置路径**: -- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json` -- **Windows**: `%APPDATA%\\Claude\\claude_desktop_config.json` - ### Claude Code CLI ```bash @@ -65,8 +36,6 @@ claude mcp add --transport http xiaohongshu-mcp http://localhost:18060/mcp ### Cursor -**重要提示**:Cursor 支持三种 MCP 传输方式:stdio、SSE 和 Streamable HTTP。对于 HTTP 服务器,应该使用 `url` 字段而不是 `command` 和 `args`。 - #### 配置文件的方式 创建或编辑 MCP 配置文件: @@ -86,7 +55,7 @@ claude mcp add --transport http xiaohongshu-mcp http://localhost:18060/mcp ``` **全局配置**: -在用户目录创建 `~/.cursor/mcp.json` (同样内容) +在用户目录创建 `~/.cursor/mcp.json` (同样内容)。 #### 使用步骤 @@ -97,21 +66,23 @@ claude mcp add --transport http xiaohongshu-mcp http://localhost:18060/mcp **Demo** -![cursor_mcp_demo](./assets/cursor_mcp_01.png) +插件 MCP 接入: + +![cursor_mcp_settings](./assets/cursor_mcp_settings.png) + +调用 MCP 工具:(以检查登录状态为例) + +![cursor_mcp_check_login](./assets/cursor_mcp_check_login.png) ### VSCode -VSCode 从 1.102 版本开始原生支持 MCP,无需安装额外扩展。 - #### 方法一:使用命令面板配置 1. 按 `Ctrl/Cmd + Shift + P` 打开命令面板 2. 运行 `MCP: Add Server` 命令 -3. 选择配置范围(Workspace 或 Global) -4. 提供服务器信息: - - **名称**: `xiaohongshu-mcp` - - **命令**: `curl` - - **参数**: `-X POST http://localhost:18060/mcp -H Content-Type:application/json -d @-` +3. 选择 `HTTP` 方式。 +4. 输入地址: `http://localhost:18060/mcp`,或者修改成对应的 Server 地址。 +5. 输入 MCP 名字: `xiaohongshu-mcp`。 #### 方法二:直接编辑配置文件 @@ -122,32 +93,26 @@ VSCode 从 1.102 版本开始原生支持 MCP,无需安装额外扩展。 { "servers": { "xiaohongshu-mcp": { - "command": "curl", - "args": [ - "-X", "POST", - "http://localhost:18060/mcp", - "-H", "Content-Type: application/json", - "-d", "@-" - ], - "description": "小红书内容发布和管理服务" + "url": "http://localhost:18060/mcp", + "type": "http" } - } + }, + "inputs": [] } ``` -**全局配置**: -运行 `MCP: Open User Configuration` 命令,添加相同内容 +**查看配置**: -#### 使用 MCP 工具 +![vscode_config](./assets/vscode_mcp_config.png) -1. 切换到 **Agent 模式**(聊天视图中选择 Agent) -2. 点击 **Tools** 按钮查看可用工具 -3. 在聊天中请求相关任务,VSCode 会自动调用相应的 MCP 工具 +1. 确认运行状态。 +2. 查看 `tools` 是否正确检测。 -#### 验证连接 +**Demo** -- 打开扩展视图,查看 **MCP SERVERS - INSTALLED** 部分 -- 成功的服务器会显示绿色状态指示器 +以搜索帖子内容为例: + +![vscode_mcp_search](./assets/vscode_search_demo.png) ### 通用 MCP Inspector(调试用) @@ -156,7 +121,7 @@ VSCode 从 1.102 版本开始原生支持 MCP,无需安装额外扩展。 npx @modelcontextprotocol/inspector # 在浏览器中连接到:http://localhost:18060/mcp -```` +``` ## 🛠️ 可用工具 @@ -211,35 +176,8 @@ npx @modelcontextprotocol/inspector } ``` -## ⚠️ 注意事项 - -1. **首次使用需要登录**:运行 `go run cmd/login/main.go` 完成登录 -2. **网络要求**:确保客户端能访问 `localhost:18060` -3. **权限验证**:某些操作需要有效的登录状态 - -## 🔧 故障排除 - -### 连接失败 - -- 检查服务是否运行:`curl http://localhost:18060/health` -- 确认端口未被占用 -- 检查防火墙设置 - -### Cursor 连接问题 - -- 确保使用正确的配置格式:HTTP 服务器使用 `url` 字段,而不是 `command` + `args` -- 重启 Cursor 应用以加载新的 MCP 配置 -- 检查是否有 "Available Tools" 显示在聊天界面中 - ### MCP Inspector 测试 - 使用 MCP Inspector 测试连接:`npx @modelcontextprotocol/inspector` - 测试 Ping Server 功能验证连接 - 检查 List Tools 是否返回 4 个工具 - -### 工具调用失败 - -- 确认已完成小红书登录 -- 检查图片 URL 或路径是否有效 -- 查看服务日志获取详细错误信息 -- 确保工具参数格式正确(特别注意 `list_feeds` 不需要参数) diff --git a/assets/cursor_mcp_01.png b/assets/cursor_mcp_01.png deleted file mode 100644 index d1ca581..0000000 Binary files a/assets/cursor_mcp_01.png and /dev/null differ diff --git a/assets/cursor_mcp_check_login.png b/assets/cursor_mcp_check_login.png new file mode 100644 index 0000000..6925f6d Binary files /dev/null and b/assets/cursor_mcp_check_login.png differ diff --git a/assets/cursor_mcp_settings.png b/assets/cursor_mcp_settings.png new file mode 100644 index 0000000..bb56ef9 Binary files /dev/null and b/assets/cursor_mcp_settings.png differ diff --git a/assets/vscode_mcp_config.png b/assets/vscode_mcp_config.png new file mode 100644 index 0000000..9d00b19 Binary files /dev/null and b/assets/vscode_mcp_config.png differ diff --git a/assets/vscode_search_demo.png b/assets/vscode_search_demo.png new file mode 100644 index 0000000..3d41663 Binary files /dev/null and b/assets/vscode_search_demo.png differ