# @enfyra/mcp-server 中文文档

规范地址：https://npmcn.com/package/%40enfyra/mcp-server/

版本：0\.3\.24
npm 元数据更新时间：2026-11-02T15:08:48.455Z
中文译文更新时间：2026-11-14T01:56:04.765Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40enfyra/mcp-server
原文对照：https://npmcn.com/package/%40enfyra/mcp-server/?lang=original

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：2.7 MB，462 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：7 个
- 首次发布：2026-03-20T16:53:24.230Z
- 最新版本发布：2026-11-02T15:08:48.144Z
- 近 30 天下载量：2607（2026-10-14 至 2026-11-12，npm 官方下载统计）
- 已发布版本数：294（近 12 个月 294 个）

## 中文简介

Enfyra 的 MCP 服务器 - 从 MCP 兼容编码工具管理 Enfyra 实例

## 安装

```sh
npm install @enfyra/mcp-server
```

也可以使用：`pnpm add @enfyra/mcp-server`、`yarn add @enfyra/mcp-server`、`bun add @enfyra/mcp-server`

## README

# Enfyra MCP 服务器

连接 Enfyra 与 MCP相兼容的编码工具,例如 Codex, Claude Code, Cursor, VS Code / GitHub Copilot, Google Antigravity, ZCode, 以及其他 STDIO MCP 主机.

## 安装和配置

从应该使用 Enfyra 的项目中运行 :

```bash
npx @enfyra/mcp-server@latest config
```

设置要求:

-   enfyra 应用程序/admin URL ,例如 `http://localhost:3000` 或者说 `https://demo.enfyra.io`· ;
-   a 一个 `ENFYRA_API_TOKEN` 从 Enfyra 管理员 UI 创建 `/me` 页面;
-   要配置的 MCP 客户端.

它写入工程本地配置, 将设置目录记录为 `ENFYRA_MCP_PROJECT_ROOT`,仅替换 `enfyra` 服务器条目.

| 客户端 | 命令 | 项目配置 |
| --- | --- | --- |
| 代码 | `npx @enfyra/mcp-server@latest config --codex` | `.codex/config.toml` |
| 克劳德代码 | `npx @enfyra/mcp-server@latest config --claude-code` | `.mcp.json` |
| 光标 | `npx @enfyra/mcp-server@latest config --cursor` | `.cursor/mcp.json` |
| VS 代码 / GitHub 副驾驶 | `npx @enfyra/mcp-server@latest config --vscode` | `.vscode/mcp.json` |
| 谷歌反重力 | `npx @enfyra/mcp-server@latest config --antigravity` | `.agents/mcp_config.json` |
| ZCode 代码 | `npx @enfyra/mcp-server@latest config --zcode` | `.zcode/config.json` |

所有支持客户的非互动设置 :

```bash
npx @enfyra/mcp-server@latest config --yes \
  --app-url http://localhost:3000 \
  --api-token efy_pat_your-token
```

删除 MCP 创建的临时源代码和本地遥测文件 :

```bash
npx @enfyra/mcp-server@latest cleanup
```

配置多个选定的客户端 :

```bash
npx @enfyra/mcp-server@latest config --cursor --claude-code
```

## 手动配置

对于接受 `mcpServers` JSON区:

```json
{
  "mcpServers": {
    "enfyra": {
      "command": "npx",
      "args": ["-y", "@enfyra/mcp-server@latest"],
      "env": {
        "ENFYRA_API_URL": "http://localhost:3000/api",
        "ENFYRA_API_TOKEN": "efy_pat_your-token"
      }
    }
  }
}
```

Codex 项目配置使用 TOML :

```toml
[mcp_servers.enfyra]
command = "npx"
args = ["-y", "@enfyra/mcp-server@latest"]

[mcp_servers.enfyra.env]
ENFYRA_API_URL = "http://localhost:3000/api"
ENFYRA_API_TOKEN = "efy_pat_your-token"
```

ZCode 使用嵌入式 `mcp.servers` JSON 结构 `.zcode/config.json`数字 :

```json
{
  "mcp": {
    "servers": {
      "enfyra": {
        "command": "npx",
        "args": ["-y", "@enfyra/mcp-server@latest"],
        "env": {
          "ENFYRA_API_URL": "http://localhost:3000/api",
          "ENFYRA_API_TOKEN": "efy_pat_your-token"
        }
      }
    }
  }
}
```

在写入配置后重新启动或重新装入 MCP 客户端. 把信物从承诺的档案中保留出来.

## 配置命令

```bash
npx @enfyra/mcp-server@latest config [options]
```

| 选项 | 使用 |
| --- | --- |
| `--app-url` | 设置 Enfyra 应用程序/ admin URL |
| `--api-token`, (中文(简体) ), `-t` | 设定 `ENFYRA_API_TOKEN` |
| `--yes` | 非交互运行 |
| `--reconfig` | 再次选择客户端并替换已有的 `enfyra` 条目 |
| `--static-tools` | 保存相容配置; 运行时间仍然只曝光 `enfyra` |
| `--codex` | 写入代码配置 |
| `--claude-code`, (中文(简体) ), `--claude` | 写入 Claude 代码配置 |
| `--cursor` | 写入光标配置 |
| `--vscode`, (中文(简体) ), `--copilot` | 写入 VS 代码 / GitHub 副驾驶配置 |
| `--antigravity` | 写入谷歌反重力配置 |
| `--zcode` | 写入 ZCode 配置 |
| `-h`, (中文(简体) ), `--help` | 显示 CLI 帮助 |

## 环境

| 变量 | 说明 | 默认 |
| --- | --- | --- |
| `ENFYRA_API_URL` | 运行时间 API 基础写入 MCP 配置 | 需求 |
| `ENFYRA_API_TOKEN` | 来自 Enfyra 管理员 UI 的程序符号 `/me` | 需求 |
| `ENFYRA_MCP_PROJECT_ROOT` | 源工作空间的绝对项目目录 | 设定 `config`; 否则使用明确的工具参数或客户端提供的根 |

MCP连接显示一个工具, `enfyra`在整个会议期间。 不需要工具加载配置 . `ENFYRA_MCP_PROFILE` 指导工作流程的发现;它不添加公共工具。 重运行 `config` 保存已有的高级设置. `ENFYRA_MCP_DYNAMIC_TOOLS` 财务报告和审定财务报表 `--static-tools` 不改变单工具运行时表面。 在更新已安装的软件包后重新连接 MCP 客户端 .

MCP直接通过 Enfyra 服务器的本地发送此 PAT `x-enfyra-pat` 头曰. 它不会以PAT来换取一个短寿命的访问符或作为"熊"符来发送.

源工作流程编制 `enfyra/` 工作目录和存储源快照和 diffs `.tmp/enfyra/<target>/<session>/` 在选定的工程内。 准备增加 `/enfyra/` 财务报告和审定财务报表 `/.tmp/enfyra/` 给项目的 `.gitignore` 在撰写来源之前。 运行时间不会从其发射目录推断项目. 在每个新的 MCP 会话中重新打开工作空间; 保留现有的本地编辑 .

## 校验连接

在配置的 MCP 客户端中打开一个新会话, 并请求它:

```text
Use Enfyra MCP to show the connected API context.
```

然后尝试只读请求 :

```text
Use Enfyra MCP to list the available tables without changing anything.
```

## 发展

此寄存器使用 Yarn 4 和 TypeScript :

```bash
yarn typecheck
yarn test
```

使用 [一般事务人员(其他职等)](https://npmcn.com/package/%40enfyra/mcp-server/AGENTS.md) 用于维护者架构,工具合同,验证规则,以及后端同步点. LLM 运行时间指导由 MCP 指令, 工具描述, 工作流程发现, 所需知识工具, 构建器, 以及实例提供, 而不是这个 README .

## 常见问题

### @enfyra/mcp-server 是什么？

Enfyra 的 MCP 服务器 - 从 MCP 兼容编码工具管理 Enfyra 实例

### 如何安装 @enfyra/mcp-server？

在项目目录运行 npm install @enfyra/mcp-server，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 mcp-server、enfyra-mcp-server，可以用 npx mcp-server 直接运行。

### @enfyra/mcp-server 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @enfyra/mcp-server 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @enfyra/mcp-server 可以商用吗？

@enfyra/mcp-server 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @enfyra/mcp-server 的下载量有多少？

根据 npm 官方下载统计，@enfyra/mcp-server 在 2026/10/14 – 2026/11/12 这 30 天内被下载 2,607 次，日均约 87 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @enfyra/mcp-server 还在维护吗？

最新版本 0\.3\.24 发布于 2026/11/02（11 天前）；至今共发布 294 个版本，其中过去 12 个月发布了 294 个；首次发布于 2026/03/21。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。