修改 vscode 接入的方式

vscode 接入的方式,更换成新的 StreamHTTP 的方式
This commit is contained in:
zy
2025-09-06 21:04:37 +08:00
parent 8c68283edb
commit f7ce2a7b16
7 changed files with 33 additions and 86 deletions

9
.vscode/mcp.json vendored Normal file
View File

@@ -0,0 +1,9 @@
{
"servers": {
"xiaohongshu-mcp": {
"url": "http://localhost:18060/mcp",
"type": "http"
}
},
"inputs": []
}

View File

@@ -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 ### Claude Code CLI
```bash ```bash
@@ -65,8 +36,6 @@ claude mcp add --transport http xiaohongshu-mcp http://localhost:18060/mcp
### Cursor ### Cursor
**重要提示**Cursor 支持三种 MCP 传输方式stdio、SSE 和 Streamable HTTP。对于 HTTP 服务器,应该使用 `url` 字段而不是 `command``args`
#### 配置文件的方式 #### 配置文件的方式
创建或编辑 MCP 配置文件: 创建或编辑 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** **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
VSCode 从 1.102 版本开始原生支持 MCP无需安装额外扩展。
#### 方法一:使用命令面板配置 #### 方法一:使用命令面板配置
1.`Ctrl/Cmd + Shift + P` 打开命令面板 1.`Ctrl/Cmd + Shift + P` 打开命令面板
2. 运行 `MCP: Add Server` 命令 2. 运行 `MCP: Add Server` 命令
3. 选择配置范围Workspace 或 Global 3. 选择 `HTTP` 方式。
4. 提供服务器信息: 4. 输入地址: `http://localhost:18060/mcp`,或者修改成对应的 Server 地址。
- **名称**: `xiaohongshu-mcp` 5. 输入 MCP 名字: `xiaohongshu-mcp`
- **命令**: `curl`
- **参数**: `-X POST http://localhost:18060/mcp -H Content-Type:application/json -d @-`
#### 方法二:直接编辑配置文件 #### 方法二:直接编辑配置文件
@@ -122,32 +93,26 @@ VSCode 从 1.102 版本开始原生支持 MCP无需安装额外扩展。
{ {
"servers": { "servers": {
"xiaohongshu-mcp": { "xiaohongshu-mcp": {
"command": "curl", "url": "http://localhost:18060/mcp",
"args": [ "type": "http"
"-X", "POST",
"http://localhost:18060/mcp",
"-H", "Content-Type: application/json",
"-d", "@-"
],
"description": "小红书内容发布和管理服务"
} }
} },
"inputs": []
} }
``` ```
**全局配置** **查看配置**
运行 `MCP: Open User Configuration` 命令,添加相同内容
#### 使用 MCP 工具 ![vscode_config](./assets/vscode_mcp_config.png)
1. 切换到 **Agent 模式**(聊天视图中选择 Agent 1. 确认运行状态。
2. 点击 **Tools** 按钮查看可用工具 2. 查看 `tools` 是否正确检测。
3. 在聊天中请求相关任务VSCode 会自动调用相应的 MCP 工具
#### 验证连接 **Demo**
- 打开扩展视图,查看 **MCP SERVERS - INSTALLED** 部分 以搜索帖子内容为例:
- 成功的服务器会显示绿色状态指示器
![vscode_mcp_search](./assets/vscode_search_demo.png)
### 通用 MCP Inspector调试用 ### 通用 MCP Inspector调试用
@@ -156,7 +121,7 @@ VSCode 从 1.102 版本开始原生支持 MCP无需安装额外扩展。
npx @modelcontextprotocol/inspector npx @modelcontextprotocol/inspector
# 在浏览器中连接到http://localhost:18060/mcp # 在浏览器中连接到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 测试
- 使用 MCP Inspector 测试连接:`npx @modelcontextprotocol/inspector` - 使用 MCP Inspector 测试连接:`npx @modelcontextprotocol/inspector`
- 测试 Ping Server 功能验证连接 - 测试 Ping Server 功能验证连接
- 检查 List Tools 是否返回 4 个工具 - 检查 List Tools 是否返回 4 个工具
### 工具调用失败
- 确认已完成小红书登录
- 检查图片 URL 或路径是否有效
- 查看服务日志获取详细错误信息
- 确保工具参数格式正确(特别注意 `list_feeds` 不需要参数)

Binary file not shown.

Before

Width:  |  Height:  |  Size: 288 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 217 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 211 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 220 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 585 KiB