docs: merge MCP_README.md into main README with collapsible sections (#39)

- Consolidate all MCP client integration docs into single README
- Replace simple client list with detailed collapsible sections
- Add enhanced quick start with service verification steps
- Include all tested configurations for Cursor, VSCode, MCP Inspector
- Preserve all demo screenshots and configuration examples
- Remove duplicate MCP_README.md file to reduce maintenance overhead

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-authored-by: Claude <noreply@anthropic.com>
This commit is contained in:
zy
2025-09-07 22:45:38 +08:00
committed by GitHub
parent 0d66edf55d
commit 6517cc1423
2 changed files with 160 additions and 196 deletions

173
README.md
View File

@@ -107,33 +107,180 @@ npx @modelcontextprotocol/inspector
本服务支持标准的 Model Context Protocol (MCP),可以接入各种支持 MCP 的 AI 客户端。
📖 **详细接入指南**[MCP_README.md](./MCP_README.md)
### 2.1. 快速开始
#### 启动 MCP 服务
```bash
# 启动 MCP 服务
# 启动服务(默认无头模式)
go run .
# 使用 Claude Code CLI 接入
# 或者有界面模式
go run . -headless=false
```
服务将运行在:`http://localhost:18060/mcp`
#### 验证服务状态
```bash
# 测试 MCP 连接
curl -X POST http://localhost:18060/mcp \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","method":"initialize","params":{},"id":1}'
```
#### Claude Code CLI 接入
```bash
# 添加 HTTP MCP 服务器
claude mcp add --transport http xiaohongshu-mcp http://localhost:18060/mcp
```
### 2.2. 支持的客户端
-**Claude Code CLI** - 官方命令行工具
-**Claude Desktop** - 桌面应用
-**Cursor** - AI 代码编辑器
-**VSCode** - 通过 MCP 扩展支持
-**MCP Inspector** - 调试工具
- ✅ 其他支持 HTTP MCP 的客户端
<details>
<summary><b>Claude Code CLI</b></summary>
官方命令行工具,已在上面快速开始部分展示:
```bash
# 添加 HTTP MCP 服务器
claude mcp add --transport http xiaohongshu-mcp http://localhost:18060/mcp
```
</details>
<details>
<summary><b>Cursor</b></summary>
#### 配置文件的方式
创建或编辑 MCP 配置文件:
**项目级配置**(推荐):
在项目根目录创建 `.cursor/mcp.json`
```json
{
"mcpServers": {
"xiaohongshu-mcp": {
"url": "http://localhost:18060/mcp",
"description": "小红书内容发布服务 - MCP Streamable HTTP"
}
}
}
```
**全局配置**
在用户目录创建 `~/.cursor/mcp.json` (同样内容)。
#### 使用步骤
1. 确保小红书 MCP 服务正在运行
2. 保存配置文件后,重启 Cursor
3. 在 Cursor 聊天中,工具应该自动可用
4. 可以通过聊天界面的 "Available Tools" 查看已连接的 MCP 工具
**Demo**
插件 MCP 接入:
![cursor_mcp_settings](./assets/cursor_mcp_settings.png)
调用 MCP 工具:(以检查登录状态为例)
![cursor_mcp_check_login](./assets/cursor_mcp_check_login.png)
</details>
<details>
<summary><b>VSCode</b></summary>
#### 方法一:使用命令面板配置
1.`Ctrl/Cmd + Shift + P` 打开命令面板
2. 运行 `MCP: Add Server` 命令
3. 选择 `HTTP` 方式。
4. 输入地址: `http://localhost:18060/mcp`,或者修改成对应的 Server 地址。
5. 输入 MCP 名字: `xiaohongshu-mcp`
#### 方法二:直接编辑配置文件
**工作区配置**(推荐):
在项目根目录创建 `.vscode/mcp.json`
```json
{
"servers": {
"xiaohongshu-mcp": {
"url": "http://localhost:18060/mcp",
"type": "http"
}
},
"inputs": []
}
```
**查看配置**
![vscode_config](./assets/vscode_mcp_config.png)
1. 确认运行状态。
2. 查看 `tools` 是否正确检测。
**Demo**
以搜索帖子内容为例:
![vscode_mcp_search](./assets/vscode_search_demo.png)
</details>
<details>
<summary><b>MCP Inspector</b></summary>
调试工具,用于测试 MCP 连接:
```bash
# 启动 MCP Inspector
npx @modelcontextprotocol/inspector
# 在浏览器中连接到http://localhost:18060/mcp
```
使用步骤:
- 使用 MCP Inspector 测试连接
- 测试 Ping Server 功能验证连接
- 检查 List Tools 是否返回 4 个工具
</details>
<details>
<summary><b>其他支持 HTTP MCP 的客户端</b></summary>
任何支持 HTTP MCP 协议的客户端都可以连接到:`http://localhost:18060/mcp`
基本配置模板:
```json
{
"name": "xiaohongshu-mcp",
"url": "http://localhost:18060/mcp",
"type": "http"
}
```
</details>
### 2.3. 可用 MCP 工具
- `check_login_status` - 检查登录状态
- `publish_content` - 发布图文内容
- `list_feeds` - 获取推荐列表
- `search_feeds` - 搜索小红书内容(前提:用户已登录
连接成功后,可使用以下 MCP 工具:
- `check_login_status` - 检查小红书登录状态(无参数)
- `publish_content` - 发布图文内容到小红书需要title, content, 可选images, video
- `list_feeds` - 获取小红书首页推荐列表(无参数)
- `search_feeds` - 搜索小红书内容需要keyword
### 2.4. 使用示例