小红书MCP

本文将指导你如何部署 xiaohongshu-mcp 项目，并通过 MCP Inspector 调试其接口，最终将其集成到支持 MCP 协议的 AI 工具（如 Trae、Cursor、Claude 等）中。

✅ 适用人群：开发者、AI 工具爱好者、自动化运营实践者
🔧 所需工具：Docker、Node.js（仅调试用）、支持 MCP 的客户端（如 Trae）

一、部署小红书 MCP 服务（Docker 方式）

1. 拉取最新镜像

docker pull xpzouying/xiaohongshu-mcp:latest

2. 启动容器并映射端口

docker run -d \
  --name xiaohongshu \
  -p 18060:18060 \
  xpzouying/xiaohongshu-mcp:latest

• 容器内部服务监听 18060 端口，通过 -p 18060:18060 映射到宿主机。

3. 验证服务是否运行成功

# 查看容器状态
docker ps

# 测试 HTTP 接口是否可达（应返回 JSON-RPC 兼容的 SSE 流或握手信息）
curl http://localhost:18060/mcp

💡 如果 curl 返回内容或连接成功，说明服务已正常启动。

二、使用 MCP Inspector 调试服务

MCP Inspector 是官方推荐的可视化调试工具。

1. 安装并启动 Inspector（无需全局安装）

确保已安装 Node.js 18+（自带 npx）：

npx @modelcontextprotocol/inspector

默认打开：http://localhost:5173

2. 连接小红书 MCP 服务

在 Inspector 界面中配置如下：

点击 Connect，即可查看注册的工具（如发布笔记、搜索等），并进行交互测试。

✅ 成功连接后，你可以在 Tools 标签页调用 publish_note 等函数，实时查看返回结果。

三、集成到支持 MCP 的 AI 客户端（以 Trae 为例）

部分工具（如 Iflow）可能存在兼容性问题，建议优先使用 Trae、Cursor 或 Claude Desktop 等对 MCP 支持更完善的客户端。

配置示例（mcp.json 或客户端设置）

{
  "mcpServers": {
    "xiaohongshu-mcp": {
      "url": "http://localhost:18060/mcp",
      "description": "小红书内容发布服务 - MCP Streamable HTTP"
    }
  }
}

使用方式

1. 在 AI 对话中提及“发布一篇小红书笔记”。

2. AI 会自动调用 xiaohongshu-mcp 提供的 publish_note 工具。

3. 你可在 MCP Inspector 的 Notifications 面板查看调用日志与结果。

⚠️ 注意：确保本地 18060 端口对客户端可访问（若客户端运行在远程或 Docker 中，需调整网络配置）。

四、常见问题排查

五、项目资源

• 📦 GitHub 仓库：xpzouying/xiaohongshu-mcp

• 🌐 项目主页：https://www.haha.ai/xiaohongshu-mcp

• 🛠️ 调试工具指南：MCP Inspector 安装与使用全指南

结语

通过 Docker 快速部署 + MCP Inspector 可视化调试 + 主流 AI 客户端集成，你可以轻松将小红书运营能力赋予 AI 助手。
此方案不仅适用于内容发布，还可扩展至自动搜索热点、监控竞品、刷推荐流等场景。

🚀 下一步建议：结合 Claude Code 自动撰写文案 + xiaohongshu-mcp 自动发布，打造全自动内容流水线！