yuppie-mcp-lark
飞书（Lark / Feishu）MCP Server — 让 AI 助手通过 MCP 协议操作飞书消息、多维表格、电子表格。
架构
本包是 MCP 壳包，底层飞书客户端逻辑拆分为独立库包 yuppie-lark（无 MCP 依赖，可单独 pip install yuppie-lark 使用），壳包通过依赖声明引用。仓库为 uv workspace 双包结构：
packages/
├── yuppie-lark/ # 纯客户端库（PyPI：yuppie-lark，import yuppie_lark）
└── yuppie-mcp-lark/ # 本 MCP 壳包（PyPI：yuppie-mcp-lark）
特性
- 消息：发送单聊/群聊消息（文本、富文本、卡片、图片等）
- 多维表格：记录增删改查、批量操作、应用/数据表管理
- 电子表格：元信息查询、工作表增删复制、范围读写、追加数据、删除行列
- 快捷操作：列过滤、批次索引、批量更新/追加、按批次读取、从 CSV 同步、清空多维表格
- 鉴权：基于飞书应用
tenant_access_token，自动刷新 - 部署：仅 stdio，本地 AI 助手友好
快速开始
Claude Code
在 .mcp.json 中添加（--refresh 强制拉取 PyPI 最新版，忽略本地缓存）：
{
"mcpServers": {
"lark": {
"type": "stdio",
"command": "uvx",
"args": ["--refresh", "yuppie-mcp-lark"],
"env": {
"LARK_APP_ID": "cli_xxx",
"LARK_APP_SECRET": "xxx"
}
}
}
}
Cursor
在 ~/.cursor/mcp.json 中添加同上配置。
Cherry Studio / Claude Desktop / OpenCode
参照上方 env 字段，按各自 MCP 配置格式填入即可。
环境变量
| 变量 | 必填 | 默认值 | 说明 |
|---|---|---|---|
LARK_APP_ID |
是 | - | 飞书应用 App ID |
LARK_APP_SECRET |
是 | - | 飞书应用 App Secret |
LARK_BASE_URL |
否 | https://open.feishu.cn |
国际版设为 https://open.larksuite.com |
可用工具（共 50 个）
消息
| 工具 | 说明 |
|---|---|
message_send |
发送消息（支持 text/post/image/interactive 等） |
card_send |
发送卡片消息（interactive，card 传卡片 schema 对象） |
card_update |
原地更新已发送的卡片（PATCH） |
云文档
| 工具 | 说明 |
|---|---|
drive_copy_file |
复制文件到指定文件夹 |
drive_delete_file |
删除文件或文件夹 |
drive_check_task |
查询异步任务状态 |
drive_upload_file |
上传文件到云空间（最大 20 MB） |
drive_list_files |
获取文件夹中的文件清单 |
drive_create_folder |
创建文件夹 |
多维表格
| 工具 | 说明 |
|---|---|
bitable_search_records |
搜索记录（支持分页、排序、过滤） |
bitable_create_record |
创建记录 |
bitable_update_record |
更新记录 |
bitable_delete_record |
删除记录 |
bitable_batch_create_records |
批量创建记录（最多 500 条） |
bitable_batch_update_records |
批量更新记录（最多 500 条） |
bitable_batch_get_records |
批量获取记录（最多 100 条） |
bitable_batch_delete_records |
批量删除记录（最多 500 条） |
bitable_create_app |
创建多维表格应用 |
bitable_copy_app |
复制多维表格应用 |
bitable_create_table |
新建数据表 |
bitable_delete_table |
删除数据表 |
多维表格快捷操作
| 工具 | 说明 |
|---|---|
quick_bitable_clear |
清空多维表格数据（分页批量删除，支持筛选） |
电子表格通用
| 工具 | 说明 |
|---|---|
sheets_get_metainfo |
获取电子表格元信息 |
sheets_get_spreadsheet |
获取电子表格 v3 信息 |
sheets_query_sheets |
查询所有工作表 |
sheets_add_sheet |
添加工作表 |
sheets_delete_sheet |
删除工作表 |
sheets_copy_sheet |
复制工作表 |
sheets_create_spreadsheet |
创建电子表格 |
sheets_read_range |
读取单范围数据 |
sheets_read_ranges |
读取多范围数据 |
sheets_write_range |
写入范围数据 |
sheets_write_image |
向单元格写入图片 |
sheets_append_data |
追加数据 |
sheets_delete_dimension |
删除行列 |
sheets_update_dimension |
更新行列属性（行高/列宽/显示隐藏） |
sheets_styles_batch_update |
批量设置单元格样式 |
电子表格快捷操作
| 工具 | 说明 |
|---|---|
quick_sheets_filter_columns |
只保留指定列，删除其余列 |
quick_sheets_set_batch_index |
按列设置批次索引 |
quick_sheets_set_header_list |
写入新表头 |
quick_sheets_get_column_last_value |
获取列最后一个非空值 |
quick_sheets_get_rows_by_batch |
按批次读取行 |
quick_sheets_batch_update |
批量更新行 |
quick_sheets_batch_append |
批量追加行 |
quick_sheets_sync_from_file |
从 CSV 文件同步数据 |
quick_sheets_clear_content |
清空工作表内容（不移除行） |
quick_sheets_clear_sheet |
清空工作表数据（删除行） |
quick_sheets_write_image |
向单元格写入图片（网络/本地/base64） |
quick_sheets_set_row_height |
设置工作表的行高（自动分批） |
quick_sheets_set_column_style |
批量设置列样式（自动分批） |
测试与调试
uv pip install -e ".[dev]"
uv run pytest -v
使用 MCP Inspector 调试（需先在 .env 配置 LARK_APP_ID / LARK_APP_SECRET）：
npx @modelcontextprotocol/inspector uv run yuppie-mcp-lark
License
MIT
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
yuppie_mcp_lark-0.5.0.tar.gz
(20.7 kB
view details)
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file yuppie_mcp_lark-0.5.0.tar.gz.
File metadata
- Download URL: yuppie_mcp_lark-0.5.0.tar.gz
- Upload date:
- Size: 20.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.9.16 {"installer":{"name":"uv","version":"0.9.16","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
3df5846b5e21029b89befd862b90d7152528c5be6bd0373472c2073ac7c27a2c
|
|
| MD5 |
1471f108d6d878ea9734e0eb9ed20e51
|
|
| BLAKE2b-256 |
c9d96662add7934c13ce1c1718f471ec45492d18dc8bace54ca147995e8599ee
|
File details
Details for the file yuppie_mcp_lark-0.5.0-py3-none-any.whl.
File metadata
- Download URL: yuppie_mcp_lark-0.5.0-py3-none-any.whl
- Upload date:
- Size: 27.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.9.16 {"installer":{"name":"uv","version":"0.9.16","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
7eebc1e0efb9937debd29f0e8d24b2613f07ea32125e95f17c246b527f901e6f
|
|
| MD5 |
0c6cc2456bf69e4a83e1ff17f4956e3c
|
|
| BLAKE2b-256 |
be363d21d2dcc00ac0b21a34ec74d0bee416b0e9add97393a0419a01da0181ca
|
