yuppie-mcp-lark
飞书（Lark / Feishu）MCP Server — 让 AI 助手通过 MCP 协议操作飞书消息、多维表格、电子表格。
特性
- 消息：发送单聊/群聊消息（文本、富文本、卡片、图片等）
- 多维表格：记录增删改查、批量操作、应用/数据表管理
- 电子表格：元信息查询、工作表增删复制、范围读写、追加数据、删除行列
- 快捷操作：列过滤、批次索引、批量更新/追加、按批次读取、从 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 |
可用工具（共 29 个）
消息
| 工具 | 说明 |
|---|---|
message_send |
发送消息（支持 text/post/image/interactive 等） |
多维表格
| 工具 | 说明 |
|---|---|
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_add_sheet |
添加工作表 |
sheets_delete_sheet |
删除工作表 |
sheets_copy_sheet |
复制工作表 |
sheets_read_range |
读取范围数据 |
sheets_write_range |
写入范围数据 |
sheets_append_data |
追加数据 |
sheets_delete_dimension |
删除行列 |
电子表格快捷操作
| 工具 | 说明 |
|---|---|
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 |
清空工作表数据（删除行） |
测试与调试
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.1.7.tar.gz
(24.8 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.1.7.tar.gz.
File metadata
- Download URL: yuppie_mcp_lark-0.1.7.tar.gz
- Upload date:
- Size: 24.8 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 |
cf7acee32a27a8051895c35e32f571e43e4e1d0ac25da80bb1c3f27d6f64576d
|
|
| MD5 |
4d4f4f069d3eaf942c0f82ae203878d7
|
|
| BLAKE2b-256 |
715fcb33d427d0b6dddd3379876cfa7815e8dec32084619e884b6cdb7442b584
|
File details
Details for the file yuppie_mcp_lark-0.1.7-py3-none-any.whl.
File metadata
- Download URL: yuppie_mcp_lark-0.1.7-py3-none-any.whl
- Upload date:
- Size: 34.7 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 |
f734fd5c4249046f9469a8c654c372b3167ec2119606d0a7b05453cdf840c1c4
|
|
| MD5 |
85132562c368a3a3b3bc90786f775854
|
|
| BLAKE2b-256 |
e14fa398196754bbaf8a6ead32d3b04edb9b7acb7d8b10d9f842ac0a533d45e5
|
