Claude Code集成飞书 MCP 实施方案

# 飞书应用凭证（从飞书开放平台获取）
FEISHU_APP_ID="cli_xxxxxxxxx"
FEISHU_APP_SECRET="xxxxxxxxxxxxxxxx"

# Node.js 路径（根据实际安装位置调整）
NODE_PATH="/Users/shouzhi/.nvm/versions/node/v22.17.0/bin"

# 自定义 MCP 项目路径（可选）
FEISHU_MCP_PROJECT="/Users/shouzhi/nvxclouds/project/feishu-mcp"

┌─────────────────┐     ┌──────────────────────────┐     ┌─────────────────┐
│   Claude Code   │────▶│  @larksuiteoapi/lark-mcp │────▶│  飞书开放平台    │
│   (MCP Client)  │◀────│      (MCP Server)        │◀────│   Open API      │
└─────────────────┘     └──────────────────────────┘     └─────────────────┘

# 验证包是否可用
npx -y @larksuiteoapi/lark-mcp --help

Usage: lark-mcp [options] [command]

Feishu/Lark MCP Tool

Options:
  -V, --version    output the version number
  -h, --help       display help for command

Commands:
  whoami           Print All User Sessions
  login [options]  Login using OAuth and get user access token
  logout [options] Logout and clear stored user access token
  mcp [options]    Start Feishu/Lark MCP Service
  help [command]   display help for command

npx -y @larksuiteoapi/lark-mcp mcp [options]

# 测试 MCP 协议初始化
echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}' | npx -y @larksuiteoapi/lark-mcp mcp -a $FEISHU_APP_ID -s $FEISHU_APP_SECRET

{
  "result": {
    "protocolVersion": "2024-11-05",
    "capabilities": {"tools": {"listChanged": true}},
    "serverInfo": {"id": "lark-mcp-server", "name": "Feishu/Lark MCP Server", "version": "0.5.1"}
  },
  "jsonrpc": "2.0",
  "id": 1
}

┌─────────────────┐     ┌──────────────────────────┐     ┌─────────────────┐
│   Claude Code   │────▶│     feishu-mcp           │────▶│  飞书开放平台    │
│   (MCP Client)  │◀────│  (自定义 MCP Server)      │◀────│   Open API      │
└─────────────────┘     └──────────────────────────┘     └─────────────────┘
                               │
                               ▼
                        ┌──────────────────┐
                        │  功能模块         │
                        ├──────────────────┤
                        │ • 文档管理        │
                        │ • 块操作（CRUD）  │
                        │ • 认证管理        │
                        └──────────────────┘

feishu-mcp/
├── src/
│   ├── index.ts          # 主入口，MCP 服务器定义
│   ├── auth/
│   │   └── token.ts      # 飞书 Token 管理
│   ├── tools/
│   │   └── document.ts   # 文档操作工具定义
│   └── types/
│       └── index.ts      # TypeScript 类型定义
├── dist/                 # 编译输出目录
├── package.json
├── tsconfig.json
└── README.md

# 如果是现有项目
cd /Users/shouzhi/nvxclouds/project/feishu-mcp
# 如果是新建项目
mkdir -p /path/to/feishu-mcp && cd /path/to/feishu-mcp

# 初始化 npm 项目
npm init -y

# 安装依赖
npm install @modelcontextprotocol/sdk zod
npm install -D typescript @types/node

npm install

{
  "name": "@nvxclouds/feishu-mcp",
  "version": "1.0.0",
  "type": "module",
  "main": "dist/index.js",
  "scripts": {
    "build": "tsc",
    "dev": "tsc --watch",
    "start": "node dist/index.js",
    "inspect": "npx @modelcontextprotocol/inspector node dist/index.js"
  },
  "dependencies": {
    "@modelcontextprotocol/sdk": "^1.12.0",
    "zod": "^3.24.0"
  },
  "devDependencies": {
    "@types/node": "^22.10.5",
    "typescript": "^5.7.3"
  },
  "engines": {
    "node": ">=20.0.0"
  }
}

npm run build

> tsc

# 无错误输出表示编译成功

ls -la dist/

total 56
drwxr-xr-x  9 shouzhi  staff    288 Jan 16 15:39 .
drwxr-xr-x  9 shouzhi  staff    288 Jan 16 15:39 ..
drwxr-xr-x  3 shouzhi  staff     96 Jan 16 15:39 auth
-rw-r--r--  1 shouzhi  staff  12345 Jan 16 15:39 index.js
drwxr-xr-x  3 shouzhi  staff     96 Jan 16 15:39 tools
drwxr-xr-x  3 shouzhi  staff     96 Jan 16 15:39 types

node dist/index.js -a $FEISHU_APP_ID -s $FEISHU_APP_SECRET

飞书 MCP 服务器已启动

npm run inspect
# 或
npx @modelcontextprotocol/inspector node dist/index.js -a $FEISHU_APP_ID -s $FEISHU_APP_SECRET

echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}' | node dist/index.js -a $FEISHU_APP_ID -s $FEISHU_APP_SECRET 2>/dev/null

{
  "result": {
    "protocolVersion": "2024-11-05",
    "capabilities": {"tools": {}},
    "serverInfo": {"name": "feishu-mcp", "version": "1.0.0"}
  },
  "jsonrpc": "2.0",
  "id": 1
}

// src/tools/document.ts
import { z } from 'zod';

// 定义工具参数 Schema
export const createDocumentSchema = z.object({
  title: z.string().describe('文档标题'),
  folder_id: z.string().optional().describe('目标文件夹 ID')
});

// 在 index.ts 中注册工具
server.setRequestHandler(ListToolsRequestSchema, async () => ({
  tools: [
    {
      name: 'feishu-create-document',
      description: '创建新的飞书云文档',
      inputSchema: zodToJsonSchema(createDocumentSchema)
    }
  ]
}));

{
  "mcpServers": {
    "feishu": {
      "type": "stdio",
      "command": "/Users/shouzhi/.nvm/versions/node/v22.17.0/bin/npx",
      "args": [
        "-y",
        "@larksuiteoapi/lark-mcp",
        "mcp",
        "-a", "<YOUR_APP_ID>",
        "-s", "<YOUR_APP_SECRET>"
      ],
      "env": {}
    },
    "feishu-edit": {
      "type": "stdio",
      "command": "/Users/shouzhi/.nvm/versions/node/v22.17.0/bin/node",
      "args": [
        "/Users/shouzhi/nvxclouds/project/feishu-mcp/dist/index.js",
        "-a", "<YOUR_APP_ID>",
        "-s", "<YOUR_APP_SECRET>"
      ],
      "env": {}
    }
  }
}

# 获取 node 路径
which node
# 输出: /Users/shouzhi/.nvm/versions/node/v22.17.0/bin/node
# 获取 npx 路径
which npx
# 输出: /Users/shouzhi/.nvm/versions/node/v22.17.0/bin/npx

Manage MCP servers
6 servers

User MCPs (/Users/shouzhi/.claude.json)
> feishu · ✓ connected
> feishu-edit · ✓ connected
  notion · ✓ connected
  canva-dev · ✓ connected

npx -y @larksuiteoapi/lark-mcp login -a <APP_ID> -s <APP_SECRET>

npx -y @larksuiteoapi/lark-mcp whoami

npx -y @larksuiteoapi/lark-mcp logout

# 退出当前会话
/exit

# 重新启动
claude

请帮我在飞书创建一个项目周报文档，包含本周完成的工作和下周计划

搜索飞书里关于 API 部署的文档

帮我读一下这个飞书文档的内容：https://xxx.feishu.cn/docx/xxxxx

给飞书群发一条消息通知大家下午3点开会

在飞书多维表格里新增一条项目记录，项目名称是"MCP集成"，状态是"进行中"

┌──────────────────┐
│  用户输入需求     │
│ "创建Redis文档"  │
└────────┬─────────┘
         │
         ▼
┌──────────────────┐
│  Claude 分析意图  │
│ 识别：创建飞书文档│
└────────┬─────────┘
         │
         ▼
┌──────────────────┐
│  选择合适的工具   │
│ docx_builtin_import│
└────────┬─────────┘
         │
         ▼
┌──────────────────┐
│  生成工具参数     │
│ {file_name, markdown}│
└────────┬─────────┘
         │
         ▼
┌──────────────────┐
│  调用 MCP 工具    │
└────────┬─────────┘
         │
         ▼
┌──────────────────┐
│  返回结果给用户   │
│ 文档链接: https://│
└──────────────────┘

Error code: 20029 redirect_uri request is invalid

http://localhost:3000/callback

# 重新登录
npx -y @larksuiteoapi/lark-mcp login -a <APP_ID> -s <APP_SECRET>

# 重启 Claude Code

{
  "mcpServers": {
    "notion": {
      "type": "http",
      "url": "https://mcp.notion.com/mcp"
    },
    "canva-dev": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@canva/cli@latest", "mcp"],
      "env": {}
    },
    "feishu": {
      "type": "stdio",
      "command": "/Users/shouzhi/.nvm/versions/node/v22.17.0/bin/npx",
      "args": [
        "-y",
        "@larksuiteoapi/lark-mcp",
        "mcp",
        "-a", "cli_a9c34f2049",
        "-s", "9CLp6eI5uLdGlNiBPtNKWg4IsJ"
      ],
      "env": {}
    },
    "feishu-edit": {
      "type": "stdio",
      "command": "/Users/shouzhi/.nvm/versions/node/v22.17.0/bin/node",
      "args": [
        "/Users/shouzhi/nvxclouds/project/feishu-mcp/dist/index.js",
        "-a", "cli_a9c3495bc6",
        "-s", "9CLp6eI5uLdGlNiBPtNKWg4IsJ"
      ],
      "env": {}
    }
  }
}