让任何 AI Agent 平台一键接入企业微信的 MCP Server
wecom-mcp-server
让任何 AI Agent 平台一键接入企业微信
快速开始 • 支持的平台 • 工具列表 • 接入指南 • English
将 wecom-cli 封装为标准 MCP (Model Context Protocol) Server，暴露 39 个工具，覆盖企业微信 7 大核心业务域。
任何支持 MCP 协议的 AI 平台，只需填入一个 URL 即可获得完整的企业微信操作能力 — 无需写代码、无需对接 API。
支持的平台
| 平台 | 接入方式 | 状态 | |------|----------|------| | Dify | MCP 工具 → 填入 URL | ✅ 已验证 | | Claude Desktop | claude_desktop_config.json | ✅ 已验证 | | FastGPT | MCP 工具 → 填入 URL | ✅ 兼容 | | MaxKB | MCP 工具 → 填入 URL | ✅ 兼容 | | Flowise | MCP 工具 → 填入 URL | ✅ 兼容 | | Langflow | MCP 工具 → 填入 URL | ✅ 兼容 | | n8n | MCP 节点 → 填入 URL | ✅ 兼容 | | Coze | MCP 插件 | ✅ 兼容 | | Cursor | MCP 配置 | ✅ 兼容 | | 其他 MCP 兼容客户端 | StreamableHTTP / SSE | ✅ 兼容 |
只要你的平台支持 MCP 协议（StreamableHTTP 或 SSE），就可以直接接入。
工具列表
| 品类 | 工具数 | 能力 | |------|--------|------| | 👤 通讯录 | 1 | 成员查询 | | 💬 消息 | 4 | 发送/接收消息、会话列表、媒体下载 | | ✅ 待办 | 6 | 创建/查询/更新/删除待办、状态变更 | | 🎥 会议 | 5 | 创建/取消会议、成员管理、查询 | | 📅 日程 | 8 | 日程 CRUD、参与人管理、闲忙查询 | | 📄 文档 | 3 | 文档创建/读取/编辑 | | 📊 智能表格 | 12 | 子表/字段/记录增删改查 |
展开查看全部 39 个工具
通讯录
get_userlist— 获取通讯录成员列表
消息
send_message— 发送文本消息（单聊/群聊）get_message— 获取会话消息记录get_msg_chat_list— 获取会话列表get_msg_media— 下载消息中的媒体文件
待办
get_todo_list— 查询待办列表get_todo_detail— 批量获取待办详情create_todo— 创建待办update_todo— 更新待办delete_todo— 删除待办change_todo_user_status— 变更待办状态
会议
create_meeting— 创建预约会议cancel_meeting— 取消会议set_invite_meeting_members— 更新会议成员list_user_meetings— 查询会议列表get_meeting_info— 获取会议详情
日程
get_schedule_list_by_range— 按时间范围查询日程get_schedule_detail— 获取日程详情create_schedule— 创建日程update_schedule— 更新日程cancel_schedule— 取消日程add_schedule_attendees— 添加日程参与者del_schedule_attendees— 删除日程参与者check_availability— 查询成员闲忙状态
文档
create_doc— 创建文档/智能表格get_doc_content— 获取文档内容（Markdown）edit_doc_content— 编辑文档内容
智能表格
smartsheet_get_sheet— 查询子表列表smartsheet_add_sheet— 添加子表smartsheet_update_sheet— 修改子表标题smartsheet_delete_sheet— 删除子表smartsheet_get_fields— 查询字段信息smartsheet_add_fields— 添加字段smartsheet_update_fields— 更新字段标题smartsheet_delete_fields— 删除字段smartsheet_get_records— 查询全部记录smartsheet_add_records— 添加记录smartsheet_update_records— 更新记录smartsheet_delete_records— 删除记录
快速开始
1. 安装 wecom-cli
npm install -g @wecom/cli
wecom-cli init # 交互式配置 Bot ID 和 Secret
需要企业微信管理后台的机器人凭证，参考 wecom-cli 文档。
2. 安装并启动 MCP Server
git clone https://github.com/Crain99/wecom-mcp-server.git
cd wecom-mcp-server
pip install .
python -m wecom_mcp_server
服务启动后监听 0.0.0.0:8787，端点：
- Streamable HTTP：
http://localhost:8787/mcp - SSE：
http://localhost:8787/sse
3. 在你的 AI 平台中接入
在平台的 MCP 工具配置中填入 Server URL 即可，平台会自动发现全部 39 个工具。
接入指南
Dify
进入 工具 → MCP 工具 → 添加，填入 URL：
http://<your-host>:8787/mcp
Claude Desktop
编辑 claude_desktop_config.json：
{
"mcpServers": {
"wecom": {
"url": "http://localhost:8787/mcp"
}
}
}
FastGPT / MaxKB / Flowise / Langflow
在对应平台的 MCP 工具配置中填入：
http://<your-host>:8787/mcp
n8n
添加 MCP Client 节点，Server URL 填入：
http://<your-host>:8787/mcp
其他 MCP 兼容客户端
本 Server 支持 StreamableHTTP 传输协议（自动兼容 SSE 回退），端点为：
http://<your-host>:8787/mcp
项目结构
wecom_mcp_server/
├── __init__.py
├── __main__.py # 入口
├── server.py # FastMCP 实例 + wecom-cli 桥接
└── tools/
├── contact.py # 通讯录 (1 tool)
├── message.py # 消息 (4 tools)
├── todo.py # 待办 (6 tools)
├── meeting.py # 会议 (5 tools)
├── schedule.py # 日程 (8 tools)
├── doc.py # 文档 (3 tools)
└── smartsheet.py # 智能表格 (12 tools)
工作原理
AI Agent 平台 本项目 企业微信
(Dify / Claude / ...) wecom-mcp-server wecom-cli
tools/list ──────────→ 返回 39 个工具定义
tools/call ──────────→ subprocess 调用 ──────→ wecom-cli <cmd>
←──────── 解析返回结果 ←────── JSON 响应