mcpserver.so LogoMCPFly
Submit
jiang-feishu-mcp logo

jiang-feishu-mcp

by upJiang

IntegrationFeishuCursorDocument Management

A Model Context Protocol (MCP) server for connecting to Feishu documents, allowing direct access to Feishu document spaces and document lists within AI clients like Cursor. It enables seamless integration with AI applications through the MCP protocol.

View on GitHub

Last updated: N/A

飞书文档 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

获取飞书应用凭证的步骤：

  1. 访问飞书开放平台并登录
  2. 创建一个企业自建应用
  3. 在应用详情页获取App ID和App Secret
  4. 确保开启了云文档相关权限（文档、表格、云空间读取权限）

在Cursor中使用

  1. 启动服务器：pnpm start
  2. 打开Cursor的设置页面
  3. 找到"Model Context Protocol"设置
  4. 添加新的MCP Server，URL填入：http://localhost:7777/mcp
  5. 保存设置

现在，您可以在Cursor中使用以下工具：

  • list-spaces: 列出所有文档空间
  • list-documents: 列出所有或指定空间的文档

示例用法

在Cursor中，您可以这样使用MCP工具：

请列出我所有的飞书文档空间

请列出空间ID为"XYZ123"中的所有文档

技术架构

该项目使用了以下技术：

  • Node.js 和 TypeScript：开发环境
  • MCP SDK：实现MCP服务器接口
  • Express：提供HTTP服务
  • 飞书开放API：访问飞书文档内容

注意事项

  • 应用需要有访问飞书云文档的权限

许可证

MIT