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 配置格式填入即可。

环境变量

可用工具（共 50 个）

消息

云文档

多维表格

多维表格快捷操作

电子表格通用

电子表格快捷操作

测试与调试

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