{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_6wsqr7b2428s","handle":"lark-mcp-bridge","url":"https://wellknown.network/agents/lark-mcp-bridge","links":{"self":"https://wellknown.network/agents/lark-mcp-bridge/record.json","html":"https://wellknown.network/agents/lark-mcp-bridge","markdown":"https://wellknown.network/agents/lark-mcp-bridge/record.md","api":"https://wellknown.network/api/v1/agents/lark-mcp-bridge","status":"https://wellknown.network/api/v1/agents/lark-mcp-bridge/status","claim":"https://wellknown.network/agents/lark-mcp-bridge/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/lark-mcp-bridge/claim.json","badge":"https://wellknown.network/agents/lark-mcp-bridge/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/lark-mcp-bridge/history","tools":"https://wellknown.network/api/v1/agents/lark-mcp-bridge/tools"},"ard":{"identifier":"urn:air::server:lark-mcp-bridge","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"lark-mcp-bridge","summary":"飞书 CLI → MCP Bridge：将 lark-cli 能力以 MCP tools 形式暴露给 AI Agent","description":"# lark-mcp-bridge\n\n将 [lark-cli](https://github.com/larksuite/cli)（飞书/Lark 官方 CLI）封装为 [MCP](https://modelcontextprotocol.io/) Server，使 AI 助手能够操作飞书。\n\n支持飞书（中国版）和 Lark（国际版），取决于 lark-cli 配置。当前仅在飞书环境下验证。\n\n## 背景\n\nAI 工作助手（如 Amazon Quick、Claude Desktop、Anthropic Coworker）出于安全设计，不能直接执行 shell 命令或调用外部 API。它们通过 MCP 协议扩展能力——MCP 是这类助手连接外部服务的唯一通道。本项目让这类助手能够操作飞书。\n\n对于有终端权限的编码工具（Claude Code、Cursor 等），同样可以通过 MCP 获得结构化的飞书操作能力，无需自行解析 CLI 输出。\n\n## 特点\n\n- **无需创建飞书应用** — 复用 lark-cli 的个人登录态，无需 App ID/Secret\n- **14 个域、219 个 API** — 通过 `lark.discover` 元工具让 Agent 按需探索，不受固定工具列表限制\n- **安全白名单** — 默认拒绝未审核操作，风险分级，破坏性操作需确认\n- **结构化交互** — 每个操作提供完整 JSON Schema（参数名、类型、枚举、必填），Agent 不需要猜参数\n- **统一错误处理** — 分类错误码（认证过期、限流、权限不足…）+ 中文恢复建议，而非裸 stderr\n- **上下文友好** — schema 按需加载，不会一次性灌入大量 help 文本占用 Agent 上下文窗口\n- **标准 MCP 协议** — 兼容任何 MCP 客户端（Amazon Quick、Claude、Cursor、opencode 等）\n\n## 前置条件\n\n- Python 3.12+\n- [lark-cli](https://github.com/larksuite/cli) 已安装并完成登录（`lark-cli auth login`）\n\n## 安装\n\n```bash\npip install lark-mcp-bridge\n\n# 或开发模式\ngit clone https://github.com/YOUR_USERNAME/lark-mcp-bridge.git\ncd lark-mcp-bridge\npip install -e \".[dev]\"\n```\n\n## 使用\n\n### 启动 Server\n\n```bash\npython -m lark_mcp_bridge.server\n```\n\n### MCP 客户端配置\n\n所有客户端的配置本质相同：\n\n```json\n{\n  \"mcpServers\": {\n    \"lark\": {\n      \"command\": \"python\",\n      \"args\": [\"-m\", \"lark_mcp_bridge.server\"]\n    }\n  }\n}\n```\n\n- **Amazon Quick Desktop**: Settings → Capabilities → MCP → Add Local\n- **Claude Code / Claude Desktop**: `~/.claude/mcp.json`\n- **Cursor**: Settings → MCP Servers → Add (type: command)\n- **opencode**: `opencode.json`\n\n## 工作原理\n\n```\nAI 客户端 ⇄ MCP (stdio) ⇄ lark-mcp-bridge ⇄ lark-cli ⇄ 飞书 API\n```\n\nbridge 不直接调用飞书 HTTP API。认证和 token 管理由 lark-cli 处理，你的 credential 不经过第三方。\n\n### 内置工具\n\n| 工具 | 功能 |\n|------|------|\n| `lark.im.messages-send` | 发送消息 |\n| `lark.calendar.agenda` | 查看日程 |\n| `lark.calendar.schedule-meeting` | 预约会议 |\n| `lark.base.record-search` | 搜索多维表格 |\n| `lark.docs.fetch` | 读取文档 |\n| `lark.contact.search-user` | 搜索联系人 |\n| `lark.sheets.read` | 读取电子表格数据 |\n|…","publisher":{"name":"loveseal","url":null},"homepage":null,"repository":null,"version":"0.2.0","license":null,"protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:lark-mcp-bridge","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","summary":"pypi","version":"pypi","description":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"productivity.calendar","name":"Calendar & Scheduling","confidence":0.814,"provenance":"derived"},{"slug":"dev.version-control","name":"Version Control","confidence":0.745,"provenance":"derived"},{"slug":"dev.terminal","name":"Terminal & Shell","confidence":0.745,"provenance":"derived"}],"categories":["dev","productivity"],"language":"fr"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"lark-mcp-bridge","registry":"pypi","observedAt":"2026-10-28T08:28:15.448Z","publishedAt":"2026-05-31T09:18:38.632041Z","latestVersion":"0.2.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"lark-mcp-bridge","url":"https://pypi.org/project/lark-mcp-bridge/","firstSeenAt":"2026-09-09T23:25:03.299Z","fetchedAt":"2026-10-28T08:27:26.782Z","normalizedAt":"2026-10-28T08:27:26.782Z"}]},"firstSeenAt":"2026-09-09T23:25:03.299Z","updatedAt":"2026-10-28T08:28:15.448Z"}