ChatGPT Feishu MCP

一个面向云端 ChatGPT 的轻量远程 MCP。常驻服务只有一个 Node.js 进程；飞书请求按需交给飞书官方 lark-cli，无需数据库、Redis 或常驻浏览器。

能力边界

仅暴露 7 个工具：

• feishu_auth_status：检查并验证当前飞书用户授权

• feishu_auth_start / feishu_auth_complete：设备码授权两步流程

• feishu_document_read：读取飞书 Docx 或 Wiki 页面，返回 Markdown

• feishu_document_create：在云空间或 Wiki 创建 Docx，可同时写入正文

• feishu_document_edit：追加、精确替换文字、在块后插入、替换单个块

• feishu_wiki_browse：列知识空间、列节点、解析节点

服务故意不提供删除、移动、权限修改、整篇覆盖、聊天和通讯录能力。所有飞书操作固定使用 user 身份。

Related MCP server: Feishu MCP Server

本机运行

要求 Node.js 22+ 和飞书官方 lark-cli：

npx @larksuite/cli@1.0.93 install
cd /root/chatgpt-feishu-mcp
npm install
npm test
npm start

默认监听 127.0.0.1:8787：

curl http://127.0.0.1:8787/healthz

飞书用户授权

在 ChatGPT 中依次调用：

1. feishu_auth_status

2. 未就绪时调用 feishu_auth_start

3. 用户打开返回的 verification_uri_complete（或 verification URL）并批准

4. 调用 feishu_auth_complete，传入 flow_id

device_code 只保存在 MCP 进程内存，不返回 ChatGPT，也不写日志。服务重启后未完成的授权流程会失效，重新开始即可。授权只申请文档内容读、Docx 创建/读/写、Wiki 空间/节点读与节点创建以及离线续期所需 scope。token 由 lark-cli 保存在 ~/.lark-cli；Docker 部署已持久化该目录。

接入云端 ChatGPT

推荐：Secure MCP Tunnel

开发和个人使用建议让服务只监听回环地址，再用 ChatGPT 的 Secure MCP Tunnel 暴露 /mcp。这样无需在本服务里再维护一套面向 ChatGPT 的 OAuth 服务，也不会把无认证端点直接暴露到公网。

在 ChatGPT 开发者模式中新建 MCP app，填入 Tunnel 给出的 HTTPS MCP URL。连接后先让 ChatGPT 调用 feishu_auth_status。

公网部署

若直接部署公网，必须在反向代理或本服务前增加符合 ChatGPT 要求的 OAuth 2.1 Authorization Code + PKCE，并使用稳定 HTTPS 域名。不要用静态 API key 代替；ChatGPT 自定义 MCP 连接不能可靠地为每个用户附加自定义密钥头。

容器启动：

docker compose up -d --build

反向代理只需转发 /mcp 和可选的 /healthz。生产环境不要把 compose 中的 127.0.0.1 端口绑定改成公网地址，除非前面已有 OAuth 网关。

Markdown 注意事项

写入内容按飞书官方 Markdown 规则解析。需要显示为字面量的 \\、反引号、*、_、[、]、$、~、< 应加反斜杠；读取后得到的转义不要删除。多行正文通过 stdin 传给 CLI，不经过 shell，因此不会发生命令注入或 shell 展开。

块编辑前，请先用 feishu_document_read(detail="with-ids") 获取最新 block ID；结构改变后不要复用旧 ID。

环境变量

见 .env.example。建议保持：

• MAX_CONCURRENT_COMMANDS=2：避免突发并发占满小机器

• MAX_CONTENT_CHARS=200000：限制单次写入大小

• HOST=127.0.0.1：仅 Tunnel / 本机代理可访问

本服务不记录工具参数或文档正文。

本机当前运行配置

MCP 已注册为 systemd 用户服务：

systemctl --user status chatgpt-feishu-mcp.service
systemctl --user restart chatgpt-feishu-mcp.service
curl http://127.0.0.1:8787/healthz

OpenAI Secure MCP Tunnel 使用 feishu-local Profile，由 tunnel-client 的本地 runtime 管理：

tunnel-client runtimes status feishu-local --json
tunnel-client doctor --profile feishu-local --explain
tunnel-client runtimes stop feishu-local
tunnel-client runtimes connect --alias feishu-local \
  --profile feishu-local \
  --tunnel-id <TUNNEL_ID> \
  --mcp-server-url http://127.0.0.1:8787/mcp \
  --runtime-api-key file:/root/.config/openai-tunnel/runtime.key

本机同时启用了 openai-feishu-tunnel.service，登录或重启后会恢复 Tunnel：

systemctl --user status openai-feishu-tunnel.service
systemctl --user restart openai-feishu-tunnel.service

Profile 位于 /root/.config/tunnel-client/feishu-local.yaml，Runtime API Key 位于 /root/.config/openai-tunnel/runtime.key，文件权限必须保持 0600。本地 Tunnel 管理界面的实际地址可从以下命令读取：

base_url=$(cat /root/.local/state/tunnel-client/health/feishu-local.url)
printf '%s/ui\n' "$base_url"