Overview
What is 飞书MCP服务器?
飞书MCP服务器是一个基于Model Context Protocol的服务，提供飞书API集成，使AI模型能够与飞书服务（文档、机器人、聊天、多维表格）交互。它适用于需要将AI助手接入飞书生态的开发者。
How to use 飞书MCP服务器?
需要Node.js 23+和pnpm。克隆仓库后安装依赖，配置飞书应用ID和密钥（通过.env或命令行参数），然后使用pnpm dev（开发）或pnpm build && node dist/index.js --stdio（STDIO模式）启动。支持STDIO和HTTP两种运行模式。
- 通过STDIO模式集成到CLI或应用
- 通过HTTP模式提供REST API和SSE连接
Key features of 飞书MCP服务器
- 读取飞书文档内容和元数据
- 发送文本消息和交互卡片到飞书聊天
- 管理群组和聊天会话
- 支持多维表格元数据、数据表和记录查询
- 支持STDIO和HTTP双运行模式
- 分层架构，类型安全，易于扩展
Use cases of 飞书MCP服务器
- 让AI助手自动读取飞书文档内容并回答问题
- 通过API自动向飞书群组发送通知或交互卡片
- 查询或同步多维表格数据供AI分析
- 构建聊天机器人，管理飞书会话信息
FAQ from 飞书MCP服务器
如何解决认证失败问题？
检查飞书应用ID和密钥是否正确，确认应用已获得所需权限范围，并确保服务器时间与飞书服务时间同步。
令牌刷新失败怎么办？
减小令牌缓存时间（默认7100秒），检查网络连接稳定性，并查看飞书开发者平台的应用状态是否正常。
需要什么运行时环境？
需要Node.js 23.0或更高版本，以及pnpm包管理器。
支持哪些部署模式？
支持STDIO模式（通过标准输入/输出通信）和HTTP模式（通过REST API和SSE连接，默认端口3344）。
如何配置飞书凭证？
通过环境变量FEISHU_APP_ID和FEISHU_APP_SECRET，或命令行参数--feishu-app-id和--feishu-app-secret设置飞书自建应用的App ID和App Secret。
