Feishu Business Operations

feishu-scenarios-mcp

面向 Feishu/Lark 的 AI 原生业务运营 MCP 服务。提供 8 个基于场景的工具，涵盖多维表格（Bitable）和审批——搜索、查询、写入、创建、AI 架构设计、审批跟踪、提醒和统计。

安装

npm install -g feishu-scenarios-mcp

或直接运行：

npx feishu-scenarios-mcp

配置

创建 .env 文件，填写 Feishu 应用凭据：

FEISHU_APP_ID=cli_xxxxxxxxxxxx
FEISHU_APP_SECRET=xxxxxxxxxxxxxxxxxxxxxxxx
FEISHU_BITABLE_APP_TOKEN=xxxxxxxxxxxx
FEISHU_ENV=feishu

变量	必填	说明
FEISHU_APP_ID	是	Developer Console 中的 Feishu 应用 ID
FEISHU_APP_SECRET	是	Feishu 应用密钥
FEISHU_BITABLE_APP_TOKEN	使用多维表格时必填	多维表格应用令牌
FEISHU_ENV	否	feishu（默认）或 lark
FEISHU_USER_ID	使用审批时必填	你的 Feishu 用户 open_id
DEEPSEEK_API_KEY	使用 AI 架构设计时必填	用于 AI 表格设计的 DeepSeek API 密钥

Claude Desktop 配置

添加到你的 claude_desktop_config.json：

{
  "mcpServers": {
    "feishu-scenarios": {
      "command": "npx",
      "args": ["-y", "feishu-scenarios-mcp"],
      "env": {
        "FEISHU_APP_ID": "cli_xxxxxxxxxxxx",
        "FEISHU_APP_SECRET": "xxxxxxxxxxxxxxxx",
        "FEISHU_BITABLE_APP_TOKEN": "xxxxxxxxxxxx",
        "FEISHU_ENV": "feishu"
      }
    }
  }
}

工具

多维表格（多维表格）

工具	说明
bitable_search	按关键词搜索表格。返回表格 ID、名称、字段预览和记录数。
bitable_query	查询记录，可选添加筛选条件。
bitable_upsert	批量写入记录。自动匹配字段名称并转换类型。
bitable_create	创建包含字段定义的新表格。
bitable_schema_ai	根据业务描述通过 AI 设计表格架构。需要 DEEPSEEK_API_KEY。

审批（审批）

工具	说明
approval_list	按状态、类型、申请人和时间范围查询审批实例。
approval_alerts	查找瓶颈和超时审批。默认阈值为 48h。
approval_stats	审批统计：按状态、类型、月份及申请人数量排名统计。

使用示例

搜索表格：

“搜一下包含‘审批’的表格”

查询记录：

“查一下积压跟踪表里 pending 状态的记录”

写入记录：

“往跟踪表写一条记录，负责人张三，状态待处理”

通过 AI 设计表格：

“帮我设计一张跟踪审批积压的表”

审批提醒：

“谁审批最慢”

审批统计：

“本月审批通过率”

Feishu 机器人（移动端）

此软件包还包含一个基于 WebSocket 的 Feishu 机器人，可用于移动端访问：

npx feishu-scenarios-mcp-bot

设置指南：docs/bot-setup.md

所需的 Feishu 权限

• approval:instance — 读取审批实例
• bitable:app — 访问多维表格
• im:message — 机器人消息
• im:message:send_as_bot — 以机器人身份发送消息

许可证

MIT