docs: 更新 MCP_README.md,增强 Claude Desktop 和 Cursor 的配置说明 (#15)

- 📝 修改 Claude Desktop 的 MCP 服务器配置示例,更新为使用 curl 命令
-  为 Cursor 添加项目级和全局配置示例,提升文档清晰度
- 🔧 更新相关图片文件,确保文档内容一致性

支持的 MCP 客户端:
 Claude Code CLI
 Claude Desktop
 Cursor
 VSCode
 MCP Inspector

🤖 Generated with [Claude Code](https://claude.ai/code)
This commit is contained in:
zy
2025-08-17 16:55:07 +08:00
committed by GitHub
parent 1ddc87349e
commit b64b241651
6 changed files with 77 additions and 25 deletions

View File

@@ -15,7 +15,11 @@
"Bash(chmod:*)", "Bash(chmod:*)",
"Bash(true)", "Bash(true)",
"Bash(go vet:*)", "Bash(go vet:*)",
"Bash(golangci-lint run:*)" "Bash(golangci-lint run:*)",
"WebSearch",
"mcp__playwright__browser_navigate",
"mcp__playwright__browser_click",
"mcp__playwright__browser_tab_select"
], ],
"deny": [] "deny": []
} }

View File

@@ -29,20 +29,33 @@ curl -X POST http://localhost:18060/mcp \
### Claude Desktop ### Claude Desktop
**重要提示**Claude Desktop 主要支持 stdio 类型的 MCP 服务器,对于 HTTP 服务器的支持有限。建议使用其他客户端如 VSCode 或 Cursor 来连接 HTTP MCP 服务器。
如果要在 Claude Desktop 中使用,需要通过代理的方式:
`~/.config/claude-desktop/claude_desktop_config.json` 中添加: `~/.config/claude-desktop/claude_desktop_config.json` 中添加:
```json ```json
{ {
"mcpServers": { "mcpServers": {
"xiaohongshu": { "xiaohongshu": {
"command": "npx", "command": "curl",
"args": ["-y", "@modelcontextprotocol/client-stdio", "http://localhost:18060/mcp"], "args": [
"-X", "POST",
"http://localhost:18060/mcp",
"-H", "Content-Type: application/json",
"-d", "@-"
],
"env": {} "env": {}
} }
} }
} }
``` ```
**配置路径**
- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
- **Windows**: `%APPDATA%\\Claude\\claude_desktop_config.json`
### Claude Code CLI ### Claude Code CLI
```bash ```bash
@@ -52,30 +65,62 @@ claude mcp add --transport http xiaohongshu-mcp http://localhost:18060/mcp
### Cursor ### Cursor
在 Cursor 设置中添加 MCP 配置: #### 配置文件的方式
创建或编辑 MCP 配置文件:
**项目级配置**(推荐):
在项目根目录创建 `.cursor/mcp.json`
```json ```json
{ {
"mcp.servers": { "mcpServers": {
"xiaohongshu": { "xiaohongshu-mcp": {
"command": "node", "command": "curl",
"args": ["-e", "/* HTTP proxy script */"], "args": [
"-X",
"POST",
"http://localhost:18060/mcp",
"-H",
"Content-Type: application/json",
"-d",
"@-"
],
"description": "小红书内容发布服务" "description": "小红书内容发布服务"
} }
} }
} }
``` ```
**全局配置**
在用户目录创建 `~/.cursor/mcp.json` (同样内容)
**Demo**
![cursor_mcp_demo](./assets/cursor_mcp_01.png)
### VSCode ### VSCode
安装 MCP 扩展并配置: VSCode 从 1.102 版本开始原生支持 MCP无需安装额外扩展。
1. 安装 [MCP for VSCode](https://marketplace.visualstudio.com/search?term=mcp&target=VSCode) 扩展 #### 方法一:使用命令面板配置
2. 在 VSCode 设置中添加配置(`Ctrl/Cmd + ,` → 搜索 "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 @-`
#### 方法二:直接编辑配置文件
**工作区配置**(推荐):
在项目根目录创建 `.vscode/mcp.json`
```json ```json
{ {
"mcp.servers": { "servers": {
"xiaohongshu-mcp": { "xiaohongshu-mcp": {
"command": "curl", "command": "curl",
"args": [ "args": [
@@ -90,18 +135,19 @@ claude mcp add --transport http xiaohongshu-mcp http://localhost:18060/mcp
} }
``` ```
或者在工作区的 `.vscode/settings.json` 中添加 **全局配置**
运行 `MCP: Open User Configuration` 命令,添加相同内容
```json #### 使用 MCP 工具
{
"mcp.servers": { 1. 切换到 **Agent 模式**(聊天视图中选择 Agent
"xiaohongshu-mcp": { 2. 点击 **Tools** 按钮查看可用工具
"transport": "http", 3. 在聊天中请求相关任务VSCode 会自动调用相应的 MCP 工具
"endpoint": "http://localhost:18060/mcp",
"description": "小红书 MCP 服务" #### 验证连接
}
} - 打开扩展视图,查看 **MCP SERVERS - INSTALLED** 部分
} - 成功的服务器会显示绿色状态指示器
### 通用 MCP Inspector调试用 ### 通用 MCP Inspector调试用
@@ -110,7 +156,7 @@ claude mcp add --transport http xiaohongshu-mcp http://localhost:18060/mcp
npx @modelcontextprotocol/inspector npx @modelcontextprotocol/inspector
# 在浏览器中连接到http://localhost:18060/mcp # 在浏览器中连接到http://localhost:18060/mcp
``` ````
## 🛠️ 可用工具 ## 🛠️ 可用工具
@@ -153,11 +199,13 @@ npx @modelcontextprotocol/inspector
## 🔧 故障排除 ## 🔧 故障排除
### 连接失败 ### 连接失败
- 检查服务是否运行:`curl http://localhost:18060/health` - 检查服务是否运行:`curl http://localhost:18060/health`
- 确认端口未被占用 - 确认端口未被占用
- 检查防火墙设置 - 检查防火墙设置
### 工具调用失败 ### 工具调用失败
- 确认已完成小红书登录 - 确认已完成小红书登录
- 检查图片 URL 或路径是否有效 - 检查图片 URL 或路径是否有效
- 查看服务日志获取详细错误信息 - 查看服务日志获取详细错误信息

BIN
assets/cursor_mcp_01.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 288 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 285 KiB

After

Width:  |  Height:  |  Size: 162 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 851 KiB

After

Width:  |  Height:  |  Size: 726 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 127 KiB

After

Width:  |  Height:  |  Size: 71 KiB