simple-qqdocs-mcp

配合 Playwright MCP 操作腾讯文档表格（.excel-container>canvas）的简易 MCP 服务。

前置条件

1. 用 Playwright MCP 打开 docs.qq.com/sheet 表格页
2. 浏览器开启 CDP，默认 http://127.0.0.1:9222
3. 若遇代理报错，在 MCP 配置中设置 ALL_PROXY=""

安装与配置

pnpm install

在 Cursor / MCP 配置中注册（路径按实际修改）：

{
  "mcpServers": {
    "simple-qqdocs": {
      "command": "node",
      "args": ["d:/1024/llm/simple-qqdocs-mcp/src/index.js"],
      "env": {
        "CDP_ENDPOINT": "http://127.0.0.1:9222",
        "ALL_PROXY": ""
      }
    }
  }
}

使用流程

1. Playwright 打开腾讯文档表格
2. 调用 refresh_grid_boundaries 或直接使用默认工具（会自动重新识别网格）
3. 页面滚动/缩放后，优先用非 quick_* 工具，或先 refresh_grid_boundaries

工具选用

| 场景 | 推荐 | |------|------| | 常规操作 | get_cell_bounds / click_cell / input_cell | | 用户明确要求 quick/快速/缓存 | quick_get_cell_bounds / quick_click_cell / quick_input_cell |

Tools

坐标与操作

| Tool | 说明 | |------|------| | refresh_grid_boundaries | 识别并刷新列标 ABCD、行标 1234 的边界缓存 | | get_cell_bounds | 默认 获取单元格边界（每次重新识别） | | quick_get_cell_bounds | 用缓存快速获取边界 | | click_cell | 默认 识别并点击单元格 | | quick_click_cell | 用缓存快速点击 | | input_cell | 默认 点击单元格并输入文本 | | quick_input_cell | 用缓存快速输入 |

单元格引用：A1（单格）、A1:C2 或 A1C2（范围）

返回格式：

• 单格 A1 → bounds: [[x1, x2], [y1, y2]]
• 范围 A1:C2 → bounds: [[x1, x2, x3, x4], [y1, y2, y3]]

基础 / 调试

| Tool | 说明 | |------|------| | get_canvas_snapshot | 获取 canvas 截图（base64 PNG） | | detect_grid | 识别行标/列标区域与边界 | | recognize_cell_text | 识别单元格文字，返回 { text, bcolor, fcolor } |

环境变量

| 变量 | 默认 | 说明 | |------|------|------| | CDP_ENDPOINT | http://127.0.0.1:9222 | 浏览器 CDP 地址 |