Files

zy 1ddc87349e docs: 完善 MCP 服务接入文档，新增 VSCode 配置支持 (#14 )

文档改进：
- 📝 重构 MCP_README.md，使文档更加简洁实用
- ✨ 新增 VSCode 的 MCP 配置示例和说明
- 🔧 提供多种配置方式：全局设置和工作区设置
- 📚 更新主 README.md，添加 VSCode 到支持的客户端列表
- 🎯 优化文档结构，提升用户体验

支持的 MCP 客户端：
✅ Claude Code CLI
✅ Claude Desktop
✅ Cursor
✅ VSCode (新增)
✅ MCP Inspector

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

Co-authored-by: Claude <noreply@anthropic.com>

2025-08-17 16:33:08 +08:00

3.1 KiB

Raw Blame History

MCP 服务接入指南

本文档介绍如何在各种 AI 客户端中接入小红书 MCP 服务。

🚀 快速开始

1. 启动 MCP 服务

# 启动服务（默认无头模式）
go run .

# 或者有界面模式
go run . -headless=false

服务将运行在：http://localhost:18060/mcp

2. 验证服务状态

# 测试 MCP 连接
curl -X POST http://localhost:18060/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"initialize","params":{},"id":1}'

📱 客户端接入

Claude Desktop

在 ~/.config/claude-desktop/claude_desktop_config.json 中添加：

{
  "mcpServers": {
    "xiaohongshu": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/client-stdio", "http://localhost:18060/mcp"],
      "env": {}
    }
  }
}

Claude Code CLI

# 添加 HTTP MCP 服务器
claude mcp add --transport http xiaohongshu-mcp http://localhost:18060/mcp

Cursor

在 Cursor 设置中添加 MCP 配置：

{
  "mcp.servers": {
    "xiaohongshu": {
      "command": "node",
      "args": ["-e", "/* HTTP proxy script */"],
      "description": "小红书内容发布服务"
    }
  }
}

VSCode

安装 MCP 扩展并配置：

安装 MCP for VSCode 扩展
在 VSCode 设置中添加配置（Ctrl/Cmd + , → 搜索 "mcp"）：

{
  "mcp.servers": {
    "xiaohongshu-mcp": {
      "command": "curl",
      "args": [
        "-X", "POST",
        "http://localhost:18060/mcp",
        "-H", "Content-Type: application/json",
        "-d", "@-"
      ],
      "description": "小红书内容发布和管理服务"
    }
  }
}

或者在工作区的 .vscode/settings.json 中添加：

{
  "mcp.servers": {
    "xiaohongshu-mcp": {
      "transport": "http",
      "endpoint": "http://localhost:18060/mcp",
      "description": "小红书 MCP 服务"
    }
  }
}

### 通用 MCP Inspector（调试用）

```bash
# 启动 MCP Inspector
npx @modelcontextprotocol/inspector

# 在浏览器中连接到：http://localhost:18060/mcp

🛠️ 可用工具

连接成功后，可使用以下 MCP 工具：

check_login_status - 检查小红书登录状态
publish_content - 发布图文内容到小红书
list_feeds - 获取小红书首页推荐列表

📝 使用示例

检查登录状态

{
  "name": "check_login_status",
  "arguments": {}
}

发布内容

{
  "name": "publish_content",
  "arguments": {
    "title": "标题",
    "content": "内容描述",
    "images": ["图片URL或本地路径"]
  }
}

⚠️ 注意事项

首次使用需要登录：运行 go run cmd/login/main.go 完成登录
网络要求：确保客户端能访问 localhost:18060
权限验证：某些操作需要有效的登录状态

🔧 故障排除

连接失败

检查服务是否运行：curl http://localhost:18060/health
确认端口未被占用
检查防火墙设置

工具调用失败

确认已完成小红书登录
检查图片URL或路径是否有效
查看服务日志获取详细错误信息

3.1 KiB Raw Blame History Unescape Escape