Feishu MCP

🚀 飞书 MCP 服务器

飞书 MCP 服务器为飞书（Feishu/Lark）应用提供了 Model Context Protocol (MCP) 服务。它允许 AI 大模型借助工具调用与飞书 API 进行交互，目前主要聚焦于多维表格操作，极大提升了飞书应用在数据处理方面的灵活性和效率。

✨ 主要特性

• 基于 Model Context Protocol (MCP) TypeScript SDK 构建，借助成熟的 SDK 保障服务的稳定性和兼容性。
• 提供飞书多维表格操作工具，方便用户对多维表格进行各类操作。
• 支持 HTTP + SSE 通信，为数据传输提供了高效、实时的解决方案。

📦 安装指南

# 安装依赖项
npm install

# 构建项目
npm run build

# 开发模式运行
npm run dev

# 通过标准输入输出运行MCP
node dist/index.js --config "{\"appId\":\"xxx\",\"appSecret\":\"xxx\"}"

# 通过SSE（服务器发送事件）运行MCP
node dist/index.js --sse --config "{\" appId\": \"xxx\", \" appSecret\": \"xxx\"}"

💻 使用示例

基础用法

以下是在飞书多维表格中创建一条新记录的示例：

# 调用 create_record 工具创建新记录
# 假设已经配置好环境，这里仅展示调用示例
# 具体参数需要根据实际情况填写
node dist/index.js --config "{\"appId\":\"xxx\",\"appSecret\":\"xxx\"}" --tool create_record --params "{\"tableId\":\"xxx\",\"fields\":{\"field1\":\"value1\",\"field2\":\"value2\"}}"

高级用法

在多维表格中搜索符合条件的记录，并对搜索结果进行批量更新：

# 先搜索符合条件的记录
node dist/index.js --config "{\"appId\":\"xxx\",\"appSecret\":\"xxx\"}" --tool search_records --params "{\"tableId\":\"xxx\",\"filter\":\"field1 = 'value1'\"}"

# 假设搜索结果存储在一个变量中，例如 result
# 然后对搜索结果中的记录进行批量更新
for record in result.records; do
  node dist/index.js --config "{\"appId\":\"xxx\",\"appSecret\":\"xxx\"}" --tool update_record --params "{\"tableId\":\"xxx\",\"recordId\":\"$record.id\",\"fields\":{\"field2\":\"new_value\"}}"
done

📚 详细文档

已实现工具

create_record

在飞书多维表格中创建一条新记录。

update_record

在飞书多维表格中更新一条记录。

list_fields

获取多维表格数据表中的所有字段。

search_records

在多维表格中搜索符合条件的记录。

delete_record

删除多维表格中的一条记录。

create_bitable_app

创建一个新的飞书多维表格应用。

create_table

创建飞书多维表格中的一个新数据表。

飞书API参考文档

• 飞书多维表格API文档
• 创建记录API
• 获取记录API
• 搜索记录API
• 删除记录API
• 创建多维表格应用API
• 创建数据表API
• 列出字段信息

📄 许可证

本项目采用 MIT 许可证。