yuppie-mcp-lark

# 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 最新版，忽略本地缓存）： ```json { "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 条） | | `bitab…