飞书MCP服务器

基本能力

产品定位

飞书MCP服务器是一个基于Model Context Protocol的服务，提供飞书API集成，使AI模型能够轻松与飞书服务交互。

核心功能

• 文档服务：读取飞书文档内容和元数据
• 机器人服务：发送文本消息和交互卡片到飞书聊天
• 聊天服务：管理群组和聊天会话
• 多模式支持：
• STDIO模式：通过标准输入/输出通信，适用于CLI环境和集成到其他应用
• HTTP模式：提供REST API和SSE连接，适用于Web服务和分布式部署
• 完善的错误处理：统一的错误处理机制，提供详细的错误信息
• 类型安全：基于TypeScript，提供完整的类型定义
• 模块化架构：易于扩展新功能和集成其他飞书API

适用场景

• 需要与飞书文档交互的AI模型
• 需要自动化发送消息或卡片的机器人应用
• 需要管理飞书聊天会话的应用
• 需要操作飞书多维表格的应用

工具列表

• get_feishu_doc_raw：获取飞书文档的原始内容
• get_feishu_doc_info：获取飞书文档的元数据信息
• send_feishu_text_message：发送文本消息到飞书聊天
• send_feishu_card：发送交互卡片到飞书聊天
• get_feishu_chat_info：获取飞书聊天的基本信息
• get_feishu_sheet_meta：获取飞书多维表格的元数据信息
• get_feishu_sheet_tables：获取飞书多维表格中的数据表列表
• get_feishu_sheet_views：获取飞书多维表格中数据表的视图列表
• get_feishu_sheet_view：获取飞书多维表格中数据表特定视图的详细信息
• get_feishu_sheet_records：获取飞书多维表格中的数据表记录
• get_feishu_sheet_record：获取飞书多维表格中的单条记录

常见问题解答

• 认证失败：检查应用ID和密钥是否正确，确认应用具有所需的权限范围，检查服务器时间是否正确同步
• 令牌刷新问题：设置更短的令牌缓存时间，检查网络连接稳定性，查看飞书开发者平台的应用状态

使用教程

使用依赖

• Node.js 23.0或更高版本
• pnpm包管理器
• 有效的飞书开发者账号和已创建的自建应用

安装教程

1. 克隆仓库

git clone https://github.com/yourusername/feishu-mcp-server.git
cd feishu-mcp-server

1. 安装依赖

pnpm install

1. 创建.env文件

# 飞书应用凭证（必填）
FEISHU_APP_ID=your_app_id
FEISHU_APP_SECRET=your_app_secret

# 服务器配置（可选）
PORT=3344
LOG_LEVEL=info

调试方式

开发模式

# 开发模式（自动重启）
pnpm dev

# 或使用普通启动
pnpm start

生产模式

# 构建项目
pnpm build

# 运行编译后的代码
node dist/index.js

STDIO模式

# 方法1：使用环境变量
NODE_ENV=cli node dist/index.js

# 方法2：使用命令行参数
node dist/index.js --stdio

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。