open-index/open-npm huggingface dataset:
npm package: @lark-project/mcp
Description: Feishu/Lark Project MCP Server
Latest version: 0.0.1

# 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.  **克隆仓库**

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

2.  **安装依赖**

    ```bash
    npm install
    ```

3.  **构建项目**

    ```bash
    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` 的实现。

```bash
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/`: 工具函数、常量和日志模块。