飞书 MCP：AI 编码工具与飞书文档的桥梁-CSDN博客

项目简介

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

核心特色

1. 无缝文档集成

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

2. 强大的文档操作能力

文档管理
- 创建新文档
- 获取文档信息
- 搜索文档
- 智能目录管理：根据飞书文档目录结构自动在合适目录下新建文档，编写内容，一步搞定
内容编辑
- 文本块操作（支持富文本样式）
- 代码块操作（支持语法高亮）
- 标题块操作（支持多级标题）
- 列表操作（有序和无序列表）
- 图片操作（图片识别）

功能详解

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

快速开始

安装服务：

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

配置 Cursor：
- 打开 Cursor 设置
- 进入 Settings > MCP Tools
- 添加服务器地址："feishu-local": { "url": "http://localhost:3333/sse" },
开始使用：
- 在 Cursor 中打开 Agent 模式
- 粘贴飞书文档链接
- 让 AI 基于文档内容执行操作