feishu-mcp-server

飞书 MCP 服务器 - 让 Claude 能操作飞书（消息/审批/通讯录）

功能特性

• 📧 消息发送 - 发送文本消息、富文本消息
• ✅ 审批管理 - 创建审批实例、查询审批状态
• 👥 通讯录 - 获取用户信息、部门用户列表

前期准备

1. 在飞书开放平台创建应用
2. 获取应用的 App ID 和 App Secret
3. 根据需要开启对应权限：
   • 消息相关：im:message:send_as_bot、im:message:send_to_bot
   • 审批相关：approval:instance:create、approval:instance:read
   • 通讯录：contact:user.baseinfo、contact:user.id

快速开始

安装

npm install -g feishu-mcp-server

配置环境变量

# 方式1: 环境变量
export FEISHU_APP_ID=your_app_id
export FEISHU_APP_SECRET=your_app_secret

# 方式2: 创建 .env 文件
cp .env.example .env
# 编辑 .env 文件填入配置

启动服务

# 标准模式
feishu-mcp-server

在 Claude/Cline 中使用

Cline 配置

在 ~/.cline/mcp_settings.json 中添加：

{
  "mcpServers": {
    "feishu": {
      "command": "feishu-mcp-server",
      "env": {
        "FEISHU_APP_ID": "your_app_id",
        "FEISHU_APP_SECRET": "your_app_secret"
      }
    }
  }
}

Claude Code 配置

在 claude.code.mcp.json 中添加：

{
  "mcpServers": {
    "feishu": {
      "command": "feishu-mcp-server",
      "args": [],
      "env": {
        "FEISHU_APP_ID": "your_app_id",
        "FEISHU_APP_SECRET": "your_app_secret"
      }
    }
  }
}

可用工具

消息

| 工具名 | 描述 | |--------|------| | feishu_message_send_text | 发送文本消息 | | feishu_message_send_rich_text | 发送富文本消息 | | feishu_message_get_user_info | 获取用户信息 | | feishu_message_get_department_users | 获取部门用户列表 |

审批

| 工具名 | 描述 | |--------|------| | feishu_approval_create_instance | 创建审批实例 | | feishu_approval_get_instance | 获取审批实例状态 |

开发

# 安装依赖
npm install

# 构建
npm run build

# 开发模式（监听文件变化自动构建）
npm run dev

# 测试
npm test

License

MIT