Skip to main content
Glama
Sign In
qzone-mcp

qzone-mcp

by komoretz
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Local

qzone-mcp

QQ 空间 操作的 MCP 服务器。

无需扫码 —— 通过 CDP 连接已登录的 Edge 浏览器，实时提取 Cookie，只要 Edge 开着就能一直用。

功能

工具

说明

qzone_check_login

检查 Edge 登录状态

qzone_get_feed_list

获取指定 QQ 号的说说列表

qzone_comment_feed

对指定说说发表评论

Related MCP server: qzone-mcp

工作原理

Edge 用 --remote-debugging-port=9222 启动
    ↓
在 Edge 里登录 QQ 空间
    ↓
MCP 工具通过 CDP 实时提取 Cookie（含 p_skey）
    ↓
调用 QQ 空间 API

只要 Edge 不关闭且登录态有效，就完全不用扫码。

安装

git clone https://github.com/komoretz/qzone-mcp.git
cd qzone-mcp
npm install

需要 Node.js >= 18。

使用步骤

1. 用调试端口启动 Edge

先关闭所有 Edge 窗口，然后双击 start-edge.bat，或运行：

"C:\Program Files (x86)\Microsoft\Edge\Application\msedge.exe" --remote-debugging-port=9222 --user-data-dir="edge-profile"

必须用 --user-data-dir 指定独立目录，否则调试端口不会生效（会复用已有 Edge 进程）。

2. 登录 QQ 空间

在弹出的 Edge 里访问 https://user.qzone.qq.com 并登录。

3. 配置 MCP 客户端

将 /path/to/qzone-mcp 替换为你的实际路径。

Claude Desktop

编辑 %APPDATA%\Claude\claude_desktop_config.json：

{
  "mcpServers": {
    "qzone": {
      "command": "node",
      "args": ["/path/to/qzone-mcp/src/index.js"],
      "cwd": "/path/to/qzone-mcp"
    }
  }
}

Cursor

设置 → MCP → 添加服务器，填入同上配置。

VS Code (Continue)

编辑 .continue/config.json：

{
  "mcpServers": {
    "qzone": {
      "command": "node",
      "args": ["/path/to/qzone-mcp/src/index.js"],
      "cwd": "/path/to/qzone-mcp"
    }
  }
}

Trae

设置 → MCP → 添加 MCP 服务器，命令为 node，参数为 index.js 的路径。

Windows 路径用正斜杠 / 或双反斜杠 \\。

4. 使用工具

  • 先调用 qzone_check_login 确认登录状态

  • 调用 qzone_get_feed_list 获取说说列表（拿到 tid）

  • 调用 qzone_comment_feed 发表评论

环境变量

变量

默认值

说明

QZONE_CDP

http://localhost:9222

Edge CDP 调试端口地址

常见问题

Q: 9222 端口连不上？ A: 确保所有 Edge 窗口已关闭，再用 start-edge.bat 启动。

Q: 提示未找到 p_skey？ A: 在 Edge 里访问 https://user.qzone.qq.com 并登录 QQ 空间。

Q: 需要每次都扫码吗？ A: 不需要。只要 Edge 开着且登录了 QQ 空间，就一直能用。

项目结构

qzone-mcp/
├── src/index.js        # MCP 服务器主文件
├── start-edge.bat      # 启动 Edge 调试模式的脚本
├── extract_cookies.py  # 可选：从 Edge 提取 Cookie 的辅助脚本
├── package.json
├── config.json         # Cookie 缓存（自动生成，不提交）
├── edge-profile/       # Edge 用户数据（不提交）
└── README.md

许可证

MIT

Available Tools

3 tools
qzone_check_loginA

检查 Edge 登录状态。确认 Edge 已用 --remote-debugging-port=9222 启动且已登录 QQ 空间。

Inputs: no named parameters.

qzone_comment_feedA

对指定说说发表评论。需先通过 qzone_get_feed_list 拿到 tid。

Inputs: tid (required), content (required), targetUin (required).

qzone_get_feed_listA

获取指定 QQ 号的说说列表，返回 tid、内容、时间等。评论前需先用本工具拿到 tid。

Inputs: targetUin (required), count.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    TDQS

    A3.9/5.0

    Scored across 3 tools

    Disambiguation5/5

    Each tool has a clearly distinct role: login check, feed listing, and commenting. The descriptions explicitly state the workflow dependency (get tid before commenting), eliminating ambiguity. No two tools could be reasonably confused.

    Naming Consistency5/5

    All three tools use the same qzone_ prefix and snake_case verb_noun pattern: qzone_check_login, qzone_get_feed_list, qzone_comment_feed. The verbs are distinct but consistent with their actions.

    Tool Count4/5

    Three tools is on the low end but still within a reasonable focused scope for a narrow Qzone commenting workflow. The set avoids bloat, though it could benefit from one or two additional operations.

    Completeness3/5

    The login -> list feeds -> comment workflow is complete, but the surface lacks common Qzone operations such as publishing a post, liking, deleting a comment, or reading existing comments. These are notable gaps for a server named qzone-mcp.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers

    • qzone-mcp

      inzzou
      A
      license
      B
      quality
      D
      maintenance
      MCP server for QZone (QQ space) integration, enabling publishing, listing, liking, and commenting on posts through the QzoneUltra daemon and NapCat.
      12
      1
      MIT

    • mihoyo-mcp

      AI1379
      A
      license
      A
      quality
      C
      maintenance
      Enables MCP clients to connect to miyoushe and HoYoLAB accounts with QR login, encrypted credential storage, multi-account and game role discovery, daily notes for Star Rail, Genshin Impact, and Zenless Zone Zero, plus stamina alert checks with deduplication.
      9
      MIT

    • QQ空间 MCP Server

      ant-cave
      F
      license
      Not graded
      quality
      C
      maintenance
      Enables authenticated querying of QQ Zone profiles, posts, statistics, albums, and message boards through MCP tools, with cookie management and optional HTTP/SSE access.
      -