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)
@@ -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": []
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -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**
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
### 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
|
After Width: | Height: | Size: 288 KiB |
|
Before Width: | Height: | Size: 285 KiB After Width: | Height: | Size: 162 KiB |
|
Before Width: | Height: | Size: 851 KiB After Width: | Height: | Size: 726 KiB |
|
Before Width: | Height: | Size: 127 KiB After Width: | Height: | Size: 71 KiB |