飞书 MCP 服务器

基本能力

产品定位

Feishu-MCP 是一个连接 AI 编码工具与飞书文档的中间件服务，旨在通过 MCP 协议提供高效的文档访问和操作能力。

核心功能

1. 文档管理：支持在指定文件夹中创建新的飞书文档。
2. 文档内容操作：
3. 获取文档基本信息（标题、版本等）和区块结构。
4. 提取文档的纯文本内容。
5. 编辑文档内容，包括文本块、标题块、代码块、列表等。
6. 批量内容创建：支持在单次操作中创建多个不同类型的内容块。
7. 计划中的功能：表格、图表、流程图、公式等高级内容的插入和识别。

适用场景

1. AI 辅助编码：Cursor 等工具可以通过飞书文档内容辅助编写代码。
2. 文档自动化管理：批量创建和编辑飞书文档，提升协作效率。
3. 内容分析与处理：提取文档纯文本内容用于分析和处理。

工具列表

1. Cursor：AI 驱动的代码编辑器，可通过 Feishu-MCP 访问飞书文档。
2. Windsurf：支持通过配置文件启动 Feishu-MCP 服务器。
3. Cline：类似 Windsurf，支持通过配置文件启动服务。
4. Claude Desktop：支持通过配置文件启动 Feishu-MCP 服务器。

常见问题解答

1. 权限问题：需确保机器人或用户有访问文档的权限。
2. 故障排查：可通过飞书开放平台调试权限和文档访问问题。
3. 文档授权：参考飞书云文档常见问题解决权限问题。

使用教程

使用依赖

1. 确保已安装 Node.js 环境。
2. 获取飞书应用 ID 和密钥（参考飞书开放平台文档）。

安装教程

1. 使用 NPM 快速运行服务器： bash npx feishu-mcp --feishu-app-id=<你的飞书应用ID> --feishu-app-secret=<你的飞书应用密钥>
2. 从本地源代码运行服务器： bash git clone <仓库地址> pnpm install cp .env.example .env pnpm run dev

调试方式

1. 验证连接：在 Cursor 设置中添加服务器 URL（如 http://localhost:3333）并点击 "Verify Connection"。
2. 测试文档访问：使用飞书开放平台 API 调试工具验证权限和文档访问。
3. 查看日志：运行服务器时查看命令行输出以排查问题。

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。