# @apex-inc/mcp-server 中文文档

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

版本：0\.54\.2
npm 元数据更新时间：2026-11-07T19:51:08.750Z
中文译文更新时间：2026-11-06T09:06:29.734Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：1.9 MB，182 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：2 个
- 首次发布：2026-04-13T02:48:08.545Z
- 最新版本发布：2026-11-07T19:51:08.575Z
- 近 30 天下载量：3719（2026-10-06 至 2026-11-04，npm 官方下载统计）
- 已发布版本数：94（近 12 个月 94 个）

## 中文简介

Apex 的 MCP 服务器. 您的编码代理对同样的顶端 仪表板使用.

## 安装

```sh
npm install @apex-inc/mcp-server
```

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

## README

# @apex-inc/mcp-服务器

Apex 的 MCP 服务器. 您的编码代理对同样的顶端 仪表板使用.

文档 : [app.apex.inc/docs/mcp](https://app.apex.inc/docs/mcp/overview)

## 从顶端安装

1.  打开 **设置 ~ AI 代理**。 。 。 .
2.  离开 **设备流动** 选中 .
3.  点击 **在光标中安装** 或者说 **在 VS 代码中安装**。 。 。 .

文件中没有键。 第一个Apex工具调用打印一个批准链接.

## 手动配置

添加为 `.cursor/mcp.json` (或你的MCP客户端的等同). 这些 `npx` 需要论证.

```json
{
  "mcpServers": {
    "apex": {
      "command": "npx",
      "args": ["-y", "-p", "@apex-inc/mcp-server@latest", "mcp-server"],
      "env": {
        "APEX_URL": "https://app.apex.inc",
        "APEX_WORKSPACE_KEY": "your-workspace-key"
      }
    }
  }
}
```

对于静态键(CI,或已锁定的笔记本电脑),添加 `APEX_API_KEY` (单位:千美元)`apex_uk_…` 或者说 `apex_sk_…`) (中文(简体) ). 打开它 **设置 ~ AI 代理**。 。 。 .

| 变量 | 需求 | 页:1 |
| --- | --- | --- |
| `APEX_URL` | 没有 | 默认为 `https://app.apex.inc`设置 `http://localhost:3000` 当地顶级. |
| `APEX_WORKSPACE_KEY` | 没有 | 开店了. `APEX_PROJECT_KEY` 是个老名字 还能用. |
| `APEX_API_KEY` | 没有 | 使用设备流时关闭. |

编辑工具列表是活目录. 在博客文章中不要将短列表当作计数 .

## 屏幕截图 CLI

剧作家运行 **他们的** 机器,然后图片上传。 顶端不能在产品上签字.

```bash
# Experiment arm (public or localhost)
npx @apex-inc/mcp-server screenshot \
  --experiment <id> --variant control --url https://example.com --preview

# Milestone still — signed-in product
npx playwright codegen --save-storage .apex/auth.json https://app.theirproduct.com
npx @apex-inc/mcp-server screenshot \
  --milestone <id> --state not_yet --url https://app.theirproduct.com/reports \
  --storage-state .apex/auth.json
npx @apex-inc/mcp-server screenshot \
  --milestone <id> --state done --url https://app.theirproduct.com/reports \
  --storage-state .apex/auth.json
```

`--storage-state` 是此机上的登录文件。 Apex从来没有收到过它——只有照片. 安装 Playwright 一次 : `npm i -D playwright && npx playwright install chromium`。 。 。 .

## 许可证

麻省理工学院——见 [自由主义](https://npmcn.com/package/%40apex-inc/mcp-server/LICENSE)

## 常见问题

### @apex-inc/mcp-server 是什么？

Apex 的 MCP 服务器\. 您的编码代理对同样的顶端 仪表板使用\.

### 如何安装 @apex-inc/mcp-server？

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

### @apex-inc/mcp-server 支持 TypeScript 吗？

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

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

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

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

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

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

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

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

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