飞书MCP服务器

飞书（Feishu）MCP服务器 - 提供多维表格和电子表格的MCP工具

功能特性

• ✅ 自动token管理（2小时有效期自动刷新）

• ✅ 多维表格完整支持（9个工具）

• ✅ 统一错误处理

• ✅ JSON格式响应

已实现功能

多维表格（Bitable）

应用管理：

• 创建多维表格应用

• 复制多维表格应用

记录操作：

• 创建/更新/查询记录

• 批量创建/更新/获取/删除记录

• 支持分页查询

电子表格（Sheets）

待实现（计划17个工具）

安装

1. 克隆项目

2. 配置环境变量

复制环境变量模板：

编辑 .env 文件，填入你的飞书应用凭证：

3. 安装依赖

使用

测试运行

作为MCP服务器运行

或使用模块方式：

Claude Desktop配置

在Claude Desktop配置文件中添加：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%\Claude\claude_desktop_config.json

Linux: ~/.config/Claude/claude_desktop_config.json

注意：将 /path/to/yuppie-mcp-feishu 替换为实际项目路径。

可用工具

多维表格应用

create_bitable_app

创建新的多维表格应用

参数：

• name (string): 多维表格名称

• folder_token (string, 可选): 文件夹token

返回：JSON格式的应用信息

copy_bitable_app

复制多维表格应用

参数：

• app_token (string): 要复制的应用token

• name (string): 新应用名称

• folder_token (string, 可选): 文件夹token

返回：JSON格式的应用信息

多维表格记录

create_bitable_record

创建单条记录

参数：

• app_token (string): 多维表格token

• table_id (string): 数据表ID

• fields (dict): 记录字段

update_bitable_record

更新单条记录

参数：

• app_token (string): 多维表格token

• table_id (string): 数据表ID

• record_id (string): 记录ID

• fields (dict): 要更新的字段

search_bitable_records

查询记录（支持分页）

参数：

• app_token (string): 多维表格token

• table_id (string): 数据表ID

• page_size (int, 可选): 每页记录数（1-500）

• page_token (string, 可选): 分页token

• filter (dict, 可选): 过滤条件

batch_create_bitable_records

批量创建记录（最多1000条）

参数：

• app_token (string): 多维表格token

• table_id (string): 数据表ID

• records (list): 记录列表

batch_update_bitable_records

批量更新记录（最多1000条）

参数：

• app_token (string): 多维表格token

• table_id (string): 数据表ID

• records (list): 记录列表（包含record_id和fields）

batch_get_bitable_records

批量获取记录（最多100条）

参数：

• app_token (string): 多维表格token

• table_id (string): 数据表ID

• record_ids (list): 记录ID列表

batch_delete_bitable_records

批量删除记录

参数：

• app_token (string): 多维表格token

• table_id (string): 数据表ID

• record_ids (list): 要删除的记录ID列表

项目结构

技术栈

• Python: >= 3.10

• 飞书SDK: lark-oapi >= 1.5.2

• MCP框架: mcp[cli] >= 1.25.0

• 包管理: UV

开发

运行测试

安装依赖

添加新依赖

参考资料

• 飞书开放平台文档

• 飞书Python SDK

• MCP协议文档

• FastMCP文档

许可证

MIT License

贡献

欢迎提交Issue和Pull Request！