飞书MCP服务器

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。