Disclaude Feishu MCP 服务器（stdio 实现）

关键词

FeishuJSON-RPC自然语言工具Claude Agent SDK自动化

使用说明（简要，面向开发者与运维人员）

  • 项目简介

    • 该仓库实现了基于模型上下文协议（MCP）的 Feishu MCP 服务器，提供用于 Feishu 聊天的上下文管理工具（如发送反馈、发送文件、更新卡片、等待互动等），通过 JSON-RPC 在客户端和服务器之间通信，当前采用 stdio 传输方式，方便在本地或容器内以进程间通信的方式进行集成。

  • 主要功能点

    • 通过标准输入输出实现 MCP JSON-RPC 的收发，响应工具调用与资源查询等请求
    • 提供 Feishu 相关工具：发送文本/卡片消息、发送文件、更新卡片、等待用户互动
    • 支持命令式的测试和集成场景的执行，包含错误处理与回退
    • 与 Claude Agent SDK 的工具定义、MCP 服务器以及上下文工具结合使用
    • 集成在 CLI/服务端场景下，适用于 Feishu 场景的任务流联动

  • 安装步骤

    • 安装依赖并构建：在仓库根目录执行安装命令后进行构建（如 npm install；npm run build）
    • 构建产物输出在 dist/ 目录下，Feishu MCP 服务器的 stdio 实现放在 dist/mcp/feishu-mcp-server.js，具备可执行权限的入口脚本
    • 配置运行环境变量（见配置需求），如 Feishu 的 App Id 和 App Secret 需通过环境变量传入

  • 服务器配置（JSON 配置，供 MCP 客户端使用） 该配置用于 MCP 客户端指定需要启动的 MCP 服务器信息。示例配置注释仅为说明用途，实际值请据需填写： { "name": "feishu-mcp-server", "command": "node", "args": ["dist/mcp/feishu-mcp-server.js"], "description": "Feishu stdio MCP 服务器，用于提供 Feishu 相关工具的 MCP 服务" } 注：

    • serverName/name: 服务器标识名称，便于在多服务器场景中区分
    • command: 启动服务器的可执行命令
    • args: 传给命令的参数列表（本实现的入口为 dist/mcp/feishu-mcp-server.js）
    • description: 服务器简要描述（可选）

  • 基本使用方法

      1. 构建运行
      • npm install
      • npm run build
      • 使用可执行的 node dist/mcp/feishu-mcp-server.js 方式启动（或通过 PM2/系统服务管理器守护运行）
      1. 与客户端结合
      • 将上方 JSON 配置提供给 MCP 客户端，用于连接并调用 Feishu 相关工具
      1. 环境配置
      • Feishu 的 App ID/Secret 需通过环境变量注入，在启动服务器时确保 FEISHU_APP_ID、FEISHU_APP_SECRET 等环境变量可用
      1. 运行模式
      • 以 stdio 传输为主的 MCP 服务，适用于容器化部署、CI 环境、以及需要直接进程间通信的场景

服务器信息

访问项目