腾讯文档 MCP Server产品系统Vibe Coding

随着 AI 编程助手（如 Claude、Cursor、Windsurf 等）的普及，MCP（Model Context Protocol）协议成为连接 AI
模型与外部工具的标准协议。腾讯文档作为国内主流在线协作文档平台，官方 MCP 服务需超级会员权限，而 OpenAPI
路径对普通开发者开放。本项目旨在解决 AI 编程助手无法直接操作腾讯文档的问题，让开发者能够通过 MCP 协议让 AI
助手读取、创建、搜索腾讯文档内容，实现 AI 与办公文档的深度集成。

项目实现了一个完整的腾讯文档 OpenAPI MCP 服务器，包含 OAuth 2.0 授权管理与腾讯文档 API 操作两大核心模块。OAuth
模块支持生成授权链接、Code 换取 Token、Token 刷新、多账户管理、默认账户切换等功能；文档操作模块支持列出文件夹内容、创建多种类型文档（
表格/文档/幻灯片/思维导图等）、获取文档元信息、按关键字搜索文件等功能。项目采用 BYOK（Bring Your Own Key）模式，每个使用者使用自己的
client_id/client_secret 独立授权，保障数据安全。

我独立负责该项目的全部开发工作，包括架构设计、核心代码编写与测试部署。技术栈采用 TypeScript + MCP SDK，使用 ESM 模块规范，通过 Stdio
传输协议与 AI 助手通信。项目亮点包括：(1) 实现滑动窗口限流器，支持 openID/fileID/导入/导出多维度频率控制，避免触发腾讯 API 限制；(2)
设计 Token 持久化存储机制，支持多账户 Token 管理与自动刷新；(3) 实现 Token 过期前自动刷新策略，提前 2 分钟主动刷新确保调用不中断；(4)
封装通用 OpenAPI 调用层，统一处理请求签名、错误解析与响应格式化。难点在于 MCP 协议的异步通信模型设计以及腾讯文档 API
频率限制的本地化实现。