Jiang Feishu Mcp

Name: Jiang Feishu Mcp
Author: upJiang

远程服务

github.com/upJiang通信协作2782 周前更新

代码仓库

关于 Jiang Feishu Mcp

这是一个用于让 MCP 客户端访问飞书文档空间与文档列表的 MCP 服务，适合需要在 Cursor 等客户端中查询飞书文档的用户。它通过飞书开放 API 提供列出全部空间及指定空间文档的工具。

主要功能

01列出全部飞书云文档空间
02列出指定空间的文档
03通过 HTTP 提供 MCP 服务
04使用飞书应用凭证访问文档

适用场景

01在 Cursor 中查看飞书文档空间
02查询某个空间中的文档列表

MCP 相关

该 MCP 服务向客户端提供 `list-spaces` 和 `list-documents` 工具，用于列出飞书空间及其文档。可通过本地 HTTP 端点连接。

#mcp #feishu #ai-integration

配置

远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。

服务地址http://localhost:7777/mcp

一键复制安装命令

Claude CodeTerminalclaude mcp add --transport http jiang-feishu http://localhost:7777/mcp

Cursor.cursor/mcp.json{"mcpServers":{"jiang-feishu":{"type":"http","url":"http://localhost:7777/mcp"}}}在 Cursor 中打开

VS Code.vscode/mcp.json{"servers":{"jiang-feishu":{"type":"http","url":"http://localhost:7777/mcp"}}}在 VS Code 中打开

Claude Desktopclaude_desktop_config.json{"mcpServers":{"jiang-feishu":{"type":"http","url":"http://localhost:7777/mcp"}}}

Windsurf~/.codeium/windsurf/mcp_config.json{"mcpServers":{"jiang-feishu":{"serverUrl":"http://localhost:7777/mcp"}}}

命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

工具

详细介绍

来自项目 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

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

访问飞书开放平台并登录
创建一个企业自建应用
在应用详情页获取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

支持 Markdown

登录后评论

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

阅读入门指南

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。