wecom-mcp-server

让任何 AI Agent 平台一键接入企业微信

将 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 响应

License

MIT

MCP Servers