Jiang Feishu Mcp
upJiang
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
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
MCP Package Docs Server
Facilitates LLMs to efficiently access and fetch structured documentation for packages in Go, Python, and NPM, enhancing software development with multi-language support and performance optimization.
Claude Code MCP
An implementation of Claude Code as a Model Context Protocol server that enables using Claude's software engineering capabilities (code generation, editing, reviewing, and file operations) through the standardized MCP interface.
@kazuph/mcp-taskmanager
Model Context Protocol server for Task Management. This allows Claude Desktop (or any MCP client) to manage and execute tasks in a queue-based system.
Linear MCP Server
Enables interaction with Linear's API for managing issues, teams, and projects programmatically through the Model Context Protocol.
mermaid-mcp-server
A Model Context Protocol (MCP) server that converts Mermaid diagrams to PNG images.
Jira-Context-MCP
MCP server to provide Jira Tickets information to AI coding agents like Cursor
Linear MCP Server
A Model Context Protocol server that integrates with Linear's issue tracking system, allowing LLMs to create, update, search, and comment on Linear issues through natural language interactions.
Sequential Thinking MCP Server
This server facilitates structured problem-solving by breaking down complex issues into sequential steps, supporting revisions, and enabling multiple solution paths through full MCP integration.