QQ MCP Server

通过 HTTP API 向 QQ 群发送消息的 MCP 服务端。基于 python-sdk 构建。

安装

pip install qq-mcp

配置

两种方式任选其一，优先级：环境变量 > config.json

方式一：config.json（推荐）

在当前工作目录创建 config.json：

{
  "qq_api_url": "http://your-api:3000",
  "qq_token": "your-bearer-token",
  "qq_group_id": "123456789",
  "message_type": "text"
}

方式二：环境变量

export QQ_API_URL="http://your-api:3000"
export QQ_TOKEN="your-bearer-token"
export QQ_GROUP_ID="123456789"
export QQ_MESSAGE_TYPE="text"      # 可选，默认 text

使用

Claude Code

在项目根目录创建 .mcp.json：

{
  "mcpServers": {
    "qq-mcp": {
      "command": "qq-mcp"
    }
  }
}

命令行

qq-mcp                        # stdio 模式（默认）
qq-mcp --transport sse        # SSE HTTP 模式
python -m qq_mcp              # 模块方式启动

手动调用

from qq_mcp import mcp

mcp.run()        # stdio
mcp.run("sse")   # SSE

工具

send_qq_message

向 QQ 群发送消息。

示例：

send_qq_message(message="Hello, QQ!")
send_qq_message(message="Hi", group_id="987654321")

hello

返回问候语。

hello(name="world")    # → "Hello, world!"

add

两数相加。

add(a=1, b=2)          # → 3.0

API 规范

服务端对接的 QQ API 接口：

POST {qq_api_url}/send_msg
Content-Type: application/json
Authorization: Bearer {qq_token}

{
  "message_type": "text",
  "group_id": "123456789",
  "message": "消息内容"
}

License

MIT