📄 feishu-mcp

让 AI Coding Agent（Cursor / Claude Code / Windsurf / OpenClaw）通过 MCP 协议直接操作飞书。

🎯 解决什么问题

你用 Cursor/Claude 写代码时，需要：

• 读飞书文档里的需求 → 以前：切换浏览器复制粘贴

• 把代码文档写到飞书 → 以前：手动创建文档再粘贴

• 给同事发个飞书消息通知 → 以前：切换到飞书App

现在：直接在 AI 对话框里说一句话就行。

🛠️ 8 个工具

🚀 安装（3步）

1. 克隆并安装依赖

git clone https://github.com/zlplzp123wyt/feishu-mcp.git
cd feishu-mcp
npm install
npm run build

2. 获取飞书应用凭证

1. 登录 飞书开放平台

2. 创建企业自建应用

3. 获取 App ID 和 App Secret

4. 开通所需权限（文档读写、消息发送等）

3. 配置 MCP Client

Cursor

在 ~/.cursor/mcp.json 中添加：

{
  "mcpServers": {
    "feishu": {
      "command": "node",
      "args": ["/path/to/feishu-mcp/dist/index.js"],
      "env": {
        "FEISHU_APP_ID": "cli_xxxxxxxxxxxxxxxx",
        "FEISHU_APP_SECRET": "xxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

Claude Desktop

在 claude_desktop_config.json 中添加相同的配置。

OpenClaw

在 OpenClaw 配置中添加 MCP server。

📋 飞书应用所需权限

🏗️ 技术栈

• TypeScript + Node.js

• MCP SDK (@modelcontextprotocol/sdk)

• Zod（参数校验）

• 飞书 Open API

💰 适用场景

• 开发者：Cursor/Claude写代码时直接操作飞书

• 团队协作：AI自动把代码文档同步到飞书

• 自动化：用AI Agent自动管理飞书内容

• 企业定制：基于此MCP server开发定制化飞书集成

📄 License

MIT