mcpField
J
Jiang Feishu Mcp

Jiang Feishu Mcp

Remote
github.com/upJiangCommunication27Updated 82w ago
Repository

About Jiang Feishu Mcp

An MCP server that lets users access Feishu document spaces and document lists from clients such as Cursor. It exposes tools for listing all spaces and documents in a selected space through the Feishu Open API.

Key features

  1. 01List all Feishu cloud document spaces
  2. 02List documents in a selected space
  3. 03Serve MCP over HTTP
  4. 04Access documents with Feishu app credentials

Use cases

  1. 01View Feishu document spaces from Cursor
  2. 02Retrieve the document list for a space

MCP support

The MCP server exposes `list-spaces` and `list-documents` tools for listing Feishu spaces and their documents. Clients can connect through its local HTTP endpoint.

#mcp#feishu#ai-integration

Configuration

Remote servers need no local install. Pick your client, then copy the config or install in one click.

Endpointhttp://localhost:7777/mcp
Copy install command
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.

Tools

Details

From the project README

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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.