QQ Channel MCP

让 AI 助手像人一样浏览和操作 QQ 频道。 Let your AI assistant browse and operate QQ Channels like a human.

中文 · English

中文

这是什么

把 QQ 频道接进 AI 助手（Claude Code 等）。浏览和操作都通过 MCP 工具完成，不是截图转发。

功能

浏览

操作

评论、发帖需要通过浏览器自动化完成（详见 SECURITY.md）。

截图

安装

git clone https://github.com/weileyao2005/qq-channel-mcp.git
cd qq-channel-mcp
pip install -r requirements.txt

配置

1. 复制配置模板：

cp config.json.example config.json

2. 浏览器打开 pd.qq.com 并扫码登录

3. F12 → Network → 任意 pd.qq.com/qunng/... 请求 → 复制完整 Cookie

4. 填入 config.json

5. 注册到 Claude Code：

{
  "mcpServers": {
    "qq-channel": {
      "command": "python",
      "args": ["/path/to/server.py"],
      "env": {"PYTHONIOENCODING": "utf-8"}
    }
  }
}

隐私

• 所有数据存储在本地 SQLite (feeds.db)

• 登录凭证仅保存在本地 config.json

• MCP server 本身不上传任何数据

• 可选的每日精选脚本（daily_digest.py / daemon.py）会把帖子内容（昵称、正文、互动数）和兴趣设置发送到 DeepSeek API 用于分类；不需要此功能就不要运行这两个脚本

• 项目代码不含任何用户凭证

免责声明

本项目为个人自动化工具，基于 QQ 频道网页版接口。接口未公开，可能随时失效。请勿用于刷量、骚扰等用途。账号风险自负。

Related MCP server: wechat-mcp

English

What is this

Connects QQ Channels to AI assistants (Claude Code, etc.) via MCP. Browsing and operations are done through tools, not screenshot forwarding.

Features

Read

Write

Commenting and publishing require browser automation (see SECURITY.md).

Screenshot

Installation

git clone https://github.com/weileyao2005/qq-channel-mcp.git
cd qq-channel-mcp
pip install -r requirements.txt

Configuration

1. Copy the template:

cp config.json.example config.json

2. Open pd.qq.com in a browser and log in

3. F12 → Network → any pd.qq.com/qunng/... request → copy the full Cookie

4. Fill it into config.json

5. Register with Claude Code:

{
  "mcpServers": {
    "qq-channel": {
      "command": "python",
      "args": ["/path/to/server.py"],
      "env": {"PYTHONIOENCODING": "utf-8"}
    }
  }
}

Privacy

• All data is stored locally in SQLite (feeds.db)

• Login credentials are kept only in local config.json

• The MCP server itself uploads nothing

• The optional digest scripts (daily_digest.py / daemon.py) send post content (nicknames, text, interaction counts) and your interest settings to the DeepSeek API for classification; skip those scripts if you do not want that

• The codebase contains no user credentials

Disclaimer

Personal automation tool based on the QQ Channel web API. The API is undocumented and may change. Do not use for spam or harassment. Use at your own risk.

License

MIT