飞书 MCP：AI 编码工具与飞书文档的桥梁

项目简介

飞书 MCP（Model Context Protocol）是一个创新的中间件服务，它架起了 AI 编码工具（如 Cursor、Windsurf、Cline 等）与飞书文档系统之间的桥梁。通过实现 MCP 协议，我们让 AI 工具能够直接访问和理解飞书文档的内容，从而提供更智能、更精准的编码辅助。

核心特色

1. 无缝文档集成

• 直接访问：AI 工具可以直接读取飞书文档，无需手动复制粘贴
• 实时同步：文档更新后，AI 工具可以立即获取最新内容
• 结构化数据：支持获取文档的完整结构，包括标题层级、代码块等

2. 强大的文档操作能力

• 文档管理

  • 创建新文档
  • 获取文档信息
  • 搜索文档
  • 智能目录管理：根据飞书文档目录结构自动在合适目录下新建文档，编写内容，一步搞定

• 内容编辑

  • 文本块操作（支持富文本样式）
  • 代码块操作（支持语法高亮）
  • 标题块操作（支持多级标题）
  • 列表操作（有序和无序列表）
  • 图片操作（图片识别）

功能详解

功能类别	功能名称	功能描述	使用场景	支持状态
文档管理	创建文档	在指定文件夹中创建新的飞书文档	新建项目文档、技术文档等	✅ 已支持
	获取文档信息	获取文档的基本信息（标题、版本等）	文档元数据分析、版本追踪	✅ 已支持
	获取文档结构	获取文档的区块结构和层级关系	文档结构分析、内容导航	✅ 已支持
	获取文档内容	获取文档的完整纯文本内容	内容分析、文本处理	✅ 已支持
	获取根文件夹	获取文档根文件夹信息	文档位置管理、路径导航	✅ 已支持
	获取文件夹内容	查看文件夹内容及文件列表	文件浏览、内容管理	✅ 已支持
	创建文件夹	创建新的文件夹	文档组织、分类管理	✅ 已支持
	搜索文档	支持按标题和内容搜索文档	快速定位、内容查找	✅ 已支持
文本操作	创建文本块	创建带有丰富样式的文本块	编写文档内容、添加说明	✅ 已支持
	文本样式设置	支持粗体、斜体、下划线、删除线、行内代码等样式	文档格式化、重点标注	✅ 已支持
	文本颜色设置	支持灰色、棕色、橙色、黄色、绿色、蓝色、紫色等颜色	内容分类、重点突出	✅ 已支持
	文本对齐设置	支持左对齐、居中、右对齐等对齐方式	文档排版、格式调整	✅ 已支持
代码操作	创建代码块	创建支持语法高亮的代码块	代码展示、技术文档编写	✅ 已支持
	代码语言支持	支持多种编程语言的语法高亮	多语言代码展示	✅ 已支持
	代码换行设置	支持自动换行设置	代码格式优化	✅ 已支持
标题操作	创建标题	支持创建从一级到九级的不同级别标题	文档结构组织、层级管理	✅ 已支持
列表操作	创建有序列表	创建带编号的列表	步骤说明、顺序展示	✅ 已支持
	创建无序列表	创建带项目符号的列表	要点列举、分类展示	✅ 已支持
批量操作	批量创建内容	支持在单次操作中创建多个不同类型的内容块	快速构建文档结构	✅ 已支持
	批量删除内容	支持删除一个或多个连续的文档块	内容清理、结构调整	✅ 已支持
Wiki支持	Wiki链接转换	将飞书Wiki链接转换为兼容的文档ID	Wiki文档访问、内容整合	✅ 已支持
图片处理	图片下载	支持通过媒体ID下载飞书图片	图片资源获取、内容保存	✅ 已支持
表格操作	创建表格	创建行列结构化数据表格	数据展示、信息整理	🔄 开发中
	编辑表格	支持表格内容编辑和格式化	数据更新、表格维护	🔄 开发中
图表功能	插入图表	支持各类数据可视化图表	数据可视化、分析展示	🔄 开发中
	编辑图表	支持图表样式和数据的编辑	图表优化、数据更新	🔄 开发中
流程图	插入流程图	支持流程图和思维导图	流程说明、思维展示	🔄 开发中
	编辑流程图	支持流程图的节点和连线编辑	流程优化、结构更新	🔄 开发中
公式功能	插入公式	支持数学公式和科学符号	技术文档、学术写作	🔄 开发中
	编辑公式	支持公式的编辑和格式化	公式更新、格式调整	🔄 开发中

快速开始

1. 安装服务：

npx feishu-mcp --feishu-app-id=<你的飞书应用ID> --feishu-app-secret=<你的飞书应用密钥>

2. 配置 Cursor：

   • 打开 Cursor 设置
   • 进入 Settings > MCP Tools
   • 添加服务器地址："feishu-local": { "url": "http://localhost:3333/sse" },

3. 开始使用：

   • 在 Cursor 中打开 Agent 模式
   • 粘贴飞书文档链接
   • 让 AI 基于文档内容执行操作

资源

• GitHub 仓库：https://github.com/cso1z/Feishu-MCP
• 问题反馈：GitHub Issues
• 飞书秘钥获取步骤：飞书配置秘钥教程
• npm:npm
• smithery:smithery

案例