@time50/simple-qqdocs-mcp

简易腾讯文档 MCP,配合 Playwright MCP 操作表格 canvas


Keywords
mcp, tencent-docs, qqdocs, playwright, spreadsheet
License
MIT
Install
npm install @time50/simple-qqdocs-mcp@0.1.0

Documentation

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:C2A1C2(范围)

返回格式

  • 单格 A1bounds: [[x1, x2], [y1, y2]]
  • 范围 A1:C2bounds: [[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 地址