Integrations
飞书 MCP 服务器
为 Cursor、Windsurf、Cline 和其他 AI 驱动的编码工具提供访问飞书文档的能力,基于 Model Context Protocol 服务器实现。
当 Cursor 能够访问飞书文档数据时,它可以更准确地理解和处理文档内容,比其他方法(如复制粘贴文本)更加高效。
核心功能
文档管理
- 创建飞书文档:支持在指定文件夹中创建新的飞书文档
文档内容操作
- 获取文档信息:
- 获取文档基本信息(标题、版本等)
- 获取文档区块结构和层级
- 获取特定区块的详细内容
- 获取文档纯文本内容:支持提取文档的完整纯文本内容,便于分析和处理
- 编辑文档内容:
- 文本块操作:
- 创建和更新带有丰富样式的文本块(粗体、斜体、下划线、删除线、行内代码)
- 支持文本颜色设置(灰色、棕色、橙色、黄色、绿色、蓝色、紫色)
- 支持文本对齐方式调整(左对齐、居中、右对齐)
- 标题块操作:创建从一级到九级的不同级别标题
- 代码块操作:
- 创建多种编程语言的代码块
- 支持代码语法高亮
- 支持自动换行设置
- 列表操作:
- 创建有序列表(编号列表)
- 创建无序列表(项目符号列表)
- 批量内容创建:支持在单次操作中创建多个不同类型的内容块
- 文本块操作:
计划中的功能
- 高级内容插入:
- 表格插入:支持行列结构化数据
- 插入图表:支持各类数据可视化图表
- 插入流程图:支持流程图和思维导图
- 插入公式:支持数学公式和科学符号
- 图表、流程图的内容识别和解析
快速开始,详见配置部分:
工作原理
- 在 Cursor 的 Agent 模式下打开编辑器。
- 粘贴飞书文档的链接。
- 要求 Cursor 基于飞书文档执行操作——例如,分析文档内容或创建相关代码。
- Cursor 将从飞书获取相关元数据并使用它来辅助编写代码。
这个 MCP 服务器专为 Cursor 设计。在响应来自飞书 API 的内容之前,它会简化和转换响应,确保只向模型提供最相关的文档信息。
安装
使用 NPM 快速运行服务器
你可以使用 NPM 快速运行服务器,无需安装或构建仓库:
已发布到smithery平台,可访问:https://smithery.ai/server/@cso1z/feishu-mcp
关于如何创建飞书应用和获取应用凭证的说明可以在官方教程找到。
详细的飞书应用配置步骤:有关注册飞书应用、配置权限、添加文档访问权限的详细指南,请参阅 手把手教程 FEISHU_CONFIG.md。
使用配置文件的工具的 JSON 配置
许多工具如 Windsurf、Cline 和 Claude Desktop 使用配置文件来启动服务器。
feishu-mcp
服务器可以通过在配置文件中添加以下内容来配置:
从本地源代码运行服务器
配置
服务器可以使用环境变量(通过 .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
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Provides access to Feishu (Lark) documents for AI-driven coding tools like Cursor, Windsurf, and Cline based on Model Context Protocol implementation.
Related MCP Servers
- -securityFlicense-qualityA demonstration project that uses Cloudflare Workers MCP to create custom AI tools that can be integrated with Claude, Cursor, and other AI assistants supporting the Model Context Protocol.Last updated -26TypeScript
- AsecurityFlicenseAqualityA starter template for building Model Context Protocol servers that can be integrated with Cursor or Claude Desktop, allowing developers to create custom tools and extensions for AI assistants.Last updated -169TypeScript
- -securityFlicense-qualityA Model Context Protocol server that enhances Claude in Cursor AI with advanced reasoning capabilities including Monte Carlo Tree Search, Beam Search, R1 Transformer, and Hybrid Reasoning methods.Last updated -1TypeScript
- -securityAlicense-qualityA Model Context Protocol server that integrates Figma design files with AI coding tools like Cursor, Windsurf, and Cline, allowing AI tools to access and understand Figma design data for generating more accurate code.Last updated -1246TypeScriptMIT License