wx-mcp — 微信 Bot MCP Server

Go 实现的 WeChat iLink Bot MCP Server，支持 stdio 和 SSE 双传输协议。

安装

cd wx-mcp
go build -o wx-mcp .

传输协议

stdio（默认）

用于 Claude Desktop、Cursor、Continue 等本地 MCP 客户端。

./wx-mcp                        # 默认 stdio
./wx-mcp -transport stdio       # 显式指定

SSE（HTTP）

用于远程访问或 Web 客户端。

./wx-mcp -transport sse -addr :8081

| 端点 | 说明 | |------|------| | GET /sse | SSE 事件流（客户端长连接） | | POST /message?sessionId=<id> | 发送 JSON-RPC 请求 | | GET /health | 健康检查 |

Claude Desktop 配置

claude_desktop_config.json：

{
  "mcpServers": {
    "wx-mcp": {
      "command": "wx-mcp",
      "args": ["-transport", "stdio"]
    }
  }
}

Cursor 配置

.cursor/mcp.json（项目级）或 ~/.cursor/mcp.json（全局）：

{
  "mcpServers": {
    "wx-mcp": {
      "command": "wx-mcp",
      "args": []
    }
  }
}

可用工具（Tools）

| 工具名 | 描述 | |--------|------| | wx_login_start | 获取扫码登录二维码 URL | | wx_login_poll | 轮询扫码状态，确认后自动注册账号并开始消息轮询 | | wx_list_accounts | 列出所有已登录账号 | | wx_account_status | 查看账号详细状态（是否暂停/冷却） | | wx_remove_account | 移除账号并停止轮询 | | wx_list_conversations | 列出账号所有会话及未读数 | | wx_get_messages | 获取与某用户的聊天记录 | | wx_get_unread | 获取所有会话未读汇总 | | wx_send_text | 向微信用户发送文字消息 | | wx_send_image | 发送图片（本地路径或 base64） | | wx_send_file | 发送文件附件 |

典型使用流程

1. wx_login_start        → 获取 qrcode_scan_url 和 session_key
2. 用微信扫二维码
3. wx_login_poll         → 轮询直到 status=confirmed，得到 account_id
4. wx_list_conversations → 查看有哪些用户发来了消息
5. wx_get_messages       → 查看具体对话内容
6. wx_send_text          → 回复用户

SSE 手动测试

# 1. 启动 SSE 服务
./wx-mcp -transport sse -addr :8081

# 2. 连接 SSE（新终端）
curl -N http://localhost:8081/sse
# 收到: event: endpoint
#       data: /message?sessionId=<UUID>

# 3. 发送 initialize 请求
curl -s -X POST "http://localhost:8081/message?sessionId=<UUID>" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}'

# 4. 列出工具
curl -s -X POST "http://localhost:8081/message?sessionId=<UUID>" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}'

MCP Servers