feishu-mcp云托管模式
github为 Cursor、Windsurf、Cline 和其他 AI 驱动的编码工具提供访问飞书文档的能力，基于 Model Context Protocol 服务器实现。当 Cursor 能够访问飞书文档数据时，它可以更准确地理解和处理文档内容，比其他方法（如复制粘贴文本）更加高效。
By cso1z
详情内容
飞书 MCP 服务器
为 Cursor、Windsurf、Cline 和其他 AI 驱动的编码工具提供访问飞书文档的能力，基于 Model Context Protocol 服务器实现。
当 Cursor 能够访问飞书文档数据时，它可以更准确地理解和处理文档内容，比其他方法（如复制粘贴文本）更加高效。
核心功能
文档管理
- 创建飞书文档：支持在指定文件夹中创建新的飞书文档
文档内容操作
- 获取文档信息：
- 获取文档基本信息（标题、版本等）
- 获取文档区块结构和层级
- 获取特定区块的详细内容
- 获取文档纯文本内容：支持提取文档的完整纯文本内容，便于分析和处理
- 编辑文档内容：
- 文本块操作：
- 创建和更新带有丰富样式的文本块（粗体、斜体、下划线、删除线、行内代码）
- 支持文本颜色设置（灰色、棕色、橙色、黄色、绿色、蓝色、紫色）
- 支持文本对齐方式调整（左对齐、居中、右对齐）
- 标题块操作：创建从一级到九级的不同级别标题
- 代码块操作：
- 创建多种编程语言的代码块
- 支持代码语法高亮
- 支持自动换行设置
- 列表操作：
- 创建有序列表（编号列表）
- 创建无序列表（项目符号列表）
- 批量内容创建：支持在单次操作中创建多个不同类型的内容块
- 文本块操作：
计划中的功能
- 高级内容插入：
- 表格插入：支持行列结构化数据
- 插入图表：支持各类数据可视化图表
- 插入流程图：支持流程图和思维导图
- 插入公式：支持数学公式和科学符号
- 图表、流程图的内容识别和解析
快速开始，详见配置部分：
npx feishu-mcp --feishu-app-id=<你的飞书应用ID> --feishu-app-secret=<你的飞书应用密钥>
工作原理
- 在 Cursor 的 Agent 模式下打开编辑器。
- 粘贴飞书文档的链接。
- 要求 Cursor 基于飞书文档执行操作——例如，分析文档内容或创建相关代码。
- Cursor 将从飞书获取相关元数据并使用它来辅助编写代码。
这个 MCP 服务器专为 Cursor 设计。在响应来自飞书 API 的内容之前，它会简化和转换响应，确保只向模型提供最相关的文档信息。
安装
使用 NPM 快速运行服务器
你可以使用 NPM 快速运行服务器，无需安装或构建仓库：
npx feishu-mcp --feishu-app-id=<你的飞书应用ID> --feishu-app-secret=<你的飞书应用密钥>
# 或
pnpx feishu-mcp --feishu-app-id=<你的飞书应用ID> --feishu-app-secret=<你的飞书应用密钥>
# 或
yarn dlx feishu-mcp --feishu-app-id=<你的飞书应用ID> --feishu-app-secret=<你的飞书应用密钥>
# 或
bunx feishu-mcp --feishu-app-id=<你的飞书应用ID> --feishu-app-secret=<你的飞书应用密钥>
已发布到smithery平台，可访问:https://smithery.ai/server/@cso1z/feishu-mcp
关于如何创建飞书应用和获取应用凭证的说明可以在官方教程找到。
详细的飞书应用配置步骤：有关注册飞书应用、配置权限、添加文档访问权限的详细指南，请参阅 手把手教程 FEISHU_CONFIG.md。
使用配置文件的工具的 JSON 配置
许多工具如 Windsurf、Cline 和 Claude Desktop 使用配置文件来启动服务器。
feishu-mcp 服务器可以通过在配置文件中添加以下内容来配置：
{
"mcpServers": {
"feishu-mcp": {
"command": "npx",
"args": ["-y", "feishu-mcp", "--stdio"],
"env": {
"FEISHU_APP_ID": "<你的飞书应用ID>",
"FEISHU_APP_SECRET": "<你的飞书应用密钥>"
}
}
}
}
从本地源代码运行服务器
- 克隆仓库
- 使用
pnpm install安装依赖 - 复制
.env.example到.env并填入你的飞书应用凭证。 - 使用
pnpm run dev运行服务器，可以使用命令行参数部分的任何标志。
配置
服务器可以使用环境变量（通过 .env 文件）或命令行参数进行配置。命令行参数优先于环境变量。
环境变量
命令行参数
--version：显示版本号--feishu-app-id：你的飞书应用 ID--feishu-app-secret：你的飞书应用密钥--port：运行服务器的端口--stdio：在命令模式下运行服务器，而不是默认的 HTTP/SSE--help：显示帮助菜单
连接到 Cursor
配置 Cursor
- 打开 Cursor 设置
- 导航到
Settings > AI > MCP Servers - 添加新服务器，URL 为
http://localhost:3333（或你配置的端口） - 点击 "Verify Connection" 确保连接成功
使用方法
- 在 Cursor 中，打开 AI 面板（默认快捷键
Cmd+K或Ctrl+K） - 如果需要新建一个飞书文档编辑信息，应该明确制定一个folderToken,可以打开一个飞书文档目录如：
https://vq5xxxxx7bc.feishu.cn/drive/folder/FPKvfjdxxxxx706RnOc查找 - 如果需要修改飞书文档内容应该明确告知飞书文档链接，例如：
https://vq5ixxxx7bc.feishu.cn/docx/J6T0d6exxxxxxxDdc1zqwnph - 询问关于文档的问题或请求基于文档内容执行操作
- 创建编辑文档都需要权限，可以到飞书开放平台对账号进行测试
https://open.feishu.cn/api-explorer/cli_a75a8ca0ac79100c?apiName=tenant_access_token_internal&from=op_doc&project=auth&resource=auth&version=v3
文档权限与故障排查
权限类型
权限分为两种：机器人权限、文档访问权限
权限验证与排查
- 获取token：https://open.feishu.cn/api-explorer/cli_a7582508c93ad00d?apiName=tenant_access_token_internal&project=auth&resource=auth&version=v3
- 使用第1步获取的token，验证是否有权限访问该文档：https://open.feishu.cn/api-explorer/cli_a7582508c93ad00d?apiName=get&project=docx&resource=document&version=v1
排查方法
在飞书开发平台测试权限正常（在开放平台调试，失败时会有充足提示信息和指导）
文档授权
如遇到权限问题，请参考云文档常见问题、知识库常见问题，特别关注如何为应用或用户开通文档权限。
许可证
MIT
通过SSE URL连接服务
Server已在腾讯云托管，可在连接后免费调用和在线进行工具测试~
工具测试
已支持Server下的17个工具，可选择工具进行在线测试
batch_create_feishu_blocks
PREFERRED: Efficiently creates multiple blocks (text, code, heading, list) in a single API call. USE THIS TOOL when creating multiple consecutive blocks at the same position - reduces API calls by up to 90%. KEY FEATURES: (1) Handles any number of blocks by auto-batching large requests (>50 blocks), (2) Creates blocks at consecutive positions in a document, (3) Supports direct heading level format (e.g. "heading1", "heading2") or standard "heading" type with level in options. CORRECT FORMAT: mcp_feishu_batch_create_feishu_blocks({documentId:"doc123",parentBlockId:"para123",startIndex:0,blocks:[{blockType:"text",options:{...}},{blockType:"heading1",options:{heading:{content:"Title"}}}]}). For separate positions, use individual block creation tools instead. For wiki links (https://xxx.feishu.cn/wiki/xxx), first convert with convert_feishu_wiki_to_document_id tool.
convert_feishu_wiki_to_document_id
Converts a Feishu Wiki document link to a compatible document ID. This conversion is required before using wiki links with any other Feishu document tools.
create_feishu_code_block
Creates a new code block with syntax highlighting and formatting options. Ideal for technical documentation, tutorials, or displaying code examples with proper formatting and language-specific highlighting. NOTE: If creating multiple blocks at once, use batch_create_feishu_blocks tool instead for better efficiency. Note: For Feishu wiki links (https://xxx.feishu.cn/wiki/xxx) you must first use convert_feishu_wiki_to_document_id tool to obtain a compatible document ID.
create_feishu_document
Creates a new Feishu document and returns its information. Use this tool when you need to create a document from scratch with a specific title and folder location.
create_feishu_folder
Creates a new folder in a specified parent folder. Use this to organize documents and files within your Feishu Drive structure. Returns the token and URL of the newly created folder.
create_feishu_heading_block
Creates a heading block with customizable level and alignment. Use this tool to add section titles, chapter headings, or any hierarchical structure elements to your document. Supports nine heading levels for different emphasis needs. NOTE: If creating multiple blocks at once, use batch_create_feishu_blocks tool instead for better efficiency. Note: For Feishu wiki links (https://xxx.feishu.cn/wiki/xxx) you must first use convert_feishu_wiki_to_document_id tool to obtain a compatible document ID.
create_feishu_list_block
Creates a list item block (either ordered or unordered). Perfect for creating hierarchical and structured content with bullet points or numbered lists. NOTE: If creating multiple blocks at once, use batch_create_feishu_blocks tool instead for better efficiency. Note: For Feishu wiki links (https://xxx.feishu.cn/wiki/xxx) you must first use convert_feishu_wiki_to_document_id tool to obtain a compatible document ID.
create_feishu_text_block
Creates a new text block with precise style control. Unlike markdown-based formatting, this tool lets you explicitly set text styles for each text segment. Ideal for formatted documents where exact styling control is needed. NOTE: If creating multiple blocks at once, use batch_create_feishu_blocks tool instead for better efficiency. Note: For Feishu wiki links (https://xxx.feishu.cn/wiki/xxx) you must first use convert_feishu_wiki_to_document_id tool to obtain a compatible document ID.
delete_feishu_document_blocks
Deletes one or more consecutive blocks from a Feishu document. Use this tool to remove unwanted content, clean up document structure, or clear space before inserting new content. Supports batch deletion for efficiency. Note: For Feishu wiki links (https://xxx.feishu.cn/wiki/xxx) you must first use convert_feishu_wiki_to_document_id tool to obtain a compatible document ID.
get_feishu_block_content
Retrieves the detailed content and structure of a specific block in a Feishu document. Useful for inspecting block properties, formatting, and content, especially before making updates or for debugging purposes. Note: For Feishu wiki links (https://xxx.feishu.cn/wiki/xxx) you must first use convert_feishu_wiki_to_document_id tool to obtain a compatible document ID.
get_feishu_document_blocks
Retrieves the block structure information of a Feishu document. Essential to use before inserting content to understand document structure and determine correct insertion positions. Returns a detailed hierarchy of blocks with their IDs, types, and content. Note: For Feishu wiki links (https://xxx.feishu.cn/wiki/xxx) you must first use convert_feishu_wiki_to_document_id tool to obtain a compatible document ID.
get_feishu_document_content
Retrieves the plain text content of a Feishu document. Ideal for content analysis, processing, or when you need to extract text without formatting. The content maintains the document structure but without styling. Note: For Feishu wiki links (https://xxx.feishu.cn/wiki/xxx) you must first use convert_feishu_wiki_to_document_id tool to obtain a compatible document ID.
get_feishu_document_info
Retrieves basic information about a Feishu document. Use this to verify a document exists, check access permissions, or get metadata like title, type, and creation information.
get_feishu_folder_files
Retrieves a list of files and subfolders in a specified folder. Use this to explore folder contents, view file metadata, and get URLs and tokens for further operations.
get_feishu_image_resource
Downloads an image resource from Feishu by its media ID. Use this to retrieve images referenced in document blocks or other Feishu resources. Returns the binary image data that can be saved or processed further. For example, extract the media_id from an image block in a document, then use this tool to download the actual image.
get_feishu_root_folder_info
Retrieves basic information about the root folder in Feishu Drive. Returns the token, ID and user ID of the root folder, which can be used for subsequent folder operations.
update_feishu_block_text
Updates the text content and styling of a specific block in a Feishu document. Can be used to modify content in existing text, code, or heading blocks while preserving the block type and other properties. Note: For Feishu wiki links (https://xxx.feishu.cn/wiki/xxx) you must first use convert_feishu_wiki_to_document_id tool to obtain a compatible document ID.
腾讯云开发者
