Feishu/Lark Project MCP Server CLI

这是一个基于 Model Context Protocol (MCP) 的 CLI 工具，旨在为 Feishu/Lark Project 提供 MCP 服务接入能力。它作为一个本地代理，通过标准输入/输出 (Stdio) 接收 MCP 请求，并将其转发到远程的 Feishu/Lark Project MCP 服务器。

功能特性

• MCP 协议支持：完整支持 Model Context Protocol，可与 Claude Desktop、Cursor 等 MCP 客户端无缝集成。
• 代理转发：将本地工具调用请求安全转发至远程服务器。
• 灵活配置：支持自定义域名、语言环境及调试模式。
• 多环境支持：支持 PPE 和 BOE 环境配置（主要用于开发和测试）。

前置要求

• Node.js >= 18
• 有效的 Feishu/Lark Project 用户 Token

安装与构建

1. 克隆仓库

   git clone <repository-url>
   cd meego-mcp-cli

2. 安装依赖

   npm install

3. 构建项目

   npm run build

   构建产物将输出到 dist/ 目录。

使用指南

命令行参数

该 CLI 工具支持以下参数：

| 参数 | 说明 | 默认值 | | :--- | :--- | :--- | | --user_token | (必需) MCP 用户 Token。也可通过环境变量 MCP_USER_TOKEN 设置。 | - | | --domain | Feishu/Lark Project 开放平台域名。 | https://project.feishu.cn | | --lang | 语言设置，支持 zh (中文) 或 en (英文)。 | - | | --debug | 开启调试模式，输出更多日志信息。 | false |

环境变量

除了命令行参数，你也可以使用环境变量进行配置（推荐在 .env 文件中设置）：

• MCP_USER_TOKEN: 默认用户 Token。
• MCP_PPE_ENV: PPE 环境标识 (X-Tt-Env header)。
• MCP_BOE_ENV: BOE 环境标识 (X-Tt-Env header)。

MCP 测试

使用@modelcontextprotocol/inspector进行测试

在开发过程中，可以使用 --debug 参数查看详细的日志输出。日志通常会输出到标准错误 (stderr) 或指定的日志文件中，具体取决于 src/utils/logger.ts 的实现。

npx @modelcontextprotocol/inspector -e MCP_BOE_ENV=xxx  node dist/index.js --debug --domain https://meego.feishu-boe.cn/ --user_token xxx

开发指南

项目结构

• src/cli/: CLI 命令解析与入口。
• src/mcp_server/: MCP Client 初始化逻辑。
• src/transport/: 包含 Stdio Server 实现，负责处理本地 MCP 通信并转发给远程 Client。
• src/utils/: 工具函数、常量和日志模块。