企业微信机器人MCP服务器

一个基于 FastMCP 框架的企业微信机器人 MCP 服务器实现。

功能特性

• 企业微信机器人对接: 支持通过 Webhook URL 方式接入企业微信机器人。
• 命令处理: 提供基础的命令处理能力，支持自定义命令扩展。
• 插件系统: 基于 FastMCP 的插件架构，方便扩展功能。
• 消息历史记录: 自动记录所有收到的消息，默认存储在内存中。

安装使用

1. 环境要求

确保你已经安装了 Python 3.10 或更高版本，并且安装以下依赖：

pip install fastmcp httpx python-multipart

2. 快速开始

创建一个新目录并初始化项目：

poetry init --no-interaction --name wecom-bot-mcp-server
poetry add fastmcp httpx python-multipart

在 src 目录下创建一个新的 Python 文件，例如 server.py:

from fastmcp import FastMCP

app = FastMCP()

@app.command(name="ping")
async def cmd_ping(ctx, args):
    return "pong"

if __name__ == "__main__":
    app.run()

在项目根目录下创建或修改 pyproject.toml 文件，添加以下内容：

[build-system]
requires = ["poetry>=1.0"]
dependencies = [
    "fastmcp",
    "httpx",
    "python-multipart"
]

3. 运行服务器

安装依赖后，在项目根目录下运行：

poetry install
poetry run python src/server.py

默认情况下，服务器将在 :8000 端口启动。

使用说明

环境变量配置

设置以下环境变量以启用企业微信机器人功能：

# Windows PowerShell
$env:WECOM_WEBHOOK_URL="你的企业微信机器人 Webhook URL"

# Linux/macOS
export WECOM_WEBHOOK_URL="你的企业微信机器人 Webhook URL"

基本命令

• ping: 返回 "pong"。
• 其他自定义命令：根据插件扩展。

消息历史记录

所有消息默认存储在内存中，可以通过调用 get_message_history() 方法获取。

在 Cline 中配置

1. 添加以下配置到你的 VSCode 设置文件（cline_mcp_settings.json）：

{
  "mcpServers": {
    "wecom-bot-server": {
      "command": "poetry run python src/server.py",
      "args": [],
      "env": {
        "WECOM_WEBHOOK_URL": "<你的企业微信机器人Webhook URL>"
      },
      "alwaysAllow": [
        "ping"
      ],
      "disabled": false
    }
  }
}

开发

克隆仓库

git clone https://github.com/loonghao/wecom-bot-mcp-server.git
cd wecom-bot-mcp-server

安装依赖

poetry install --with dev

运行测试

poetry run pytest tests/ --cov=wecom_bot_mcp_server

代码检查

poetry run ruff check .
poetry run ruff format .
poetry run mypy src/wecom_bot_mcp_server --strict

项目依赖

• Python >= 3.10
• FastMCP >= 0.4.1
• httpx >= 0.24.1

许可证

本项目遵循 MIT License 协议。

贡献

欢迎提交 Issue 和 Pull Request！