飞书文档 MCP
一个用于连接飞书文档的Model Context Protocol (MCP) 服务，可以在Cursor等AI客户端中直接访问飞书文档空间和文档列表。
功能特点
- 支持获取飞书全部云文档空间列表
- 支持获取指定空间的文档列表
- 通过MCP协议与AI客户端无缝连接
什么是MCP
MCP (Model Context Protocol) 是一个将自定义服务与各种LLM客户端（如Claude、Cursor）无缝连接的协议。它允许AI直接调用和使用我们的服务功能。
- MCP客户端：AI应用程序（如Claude Desktop或Cursor），负责发起请求并与服务器通信
- MCP服务器：本项目，暴露飞书文档功能，通过标准化协议与客户端交互
安装与运行
从源码安装
# 克隆项目
git clone https://github.com/yourusername/jiang-feishu-mcp.git
cd jiang-feishu-mcp
# 安装依赖
pnpm install
# 启动服务
pnpm start服务器将在本地7777端口启动。
配置
在使用前，您需要创建一个.env文件配置飞书应用凭证：
# 复制示例配置文件
cp .env.example .env然后编辑.env文件，填入您的飞书应用凭证：
FEISHU_APP_ID=your_app_id_here
FEISHU_APP_SECRET=your_app_secret_here
# 可选：设置端口号 (默认为7777)
PORT=7777
# 可选：设置文档保存路径 (默认为 ./docs)
DOCS_SAVE_PATH=./docs获取飞书应用凭证的步骤：
- 访问飞书开放平台并登录
- 创建一个企业自建应用
- 在应用详情页获取App ID和App Secret
- 确保开启了云文档相关权限（文档、表格、云空间读取权限）
在Cursor中使用
- 启动服务器：
pnpm start - 打开Cursor的设置页面
- 找到"Model Context Protocol"设置
- 添加新的MCP Server，URL填入：
http://localhost:7777/mcp - 保存设置
现在，您可以在Cursor中使用以下工具：
list-spaces: 列出所有文档空间list-documents: 列出所有或指定空间的文档
示例用法
在Cursor中，您可以这样使用MCP工具：
请列出我所有的飞书文档空间请列出空间ID为"XYZ123"中的所有文档技术架构
该项目使用了以下技术：
- Node.js 和 TypeScript：开发环境
- MCP SDK：实现MCP服务器接口
- Express：提供HTTP服务
- 飞书开放API：访问飞书文档内容
注意事项
- 应用需要有访问飞书云文档的权限
许可证
MIT