# @context-forge/mcp 中文文档

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

版本：0\.19\.26
npm 元数据更新时间：2026-11-07T13:05:27.509Z
中文译文更新时间：2026-11-10T19:08:38.493Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40context-forge/mcp
原文对照：https://npmcn.com/package/%40context-forge/mcp/?lang=original
项目主页：https://github.com/ecorkran/context-forge/tree/main/packages/mcp-server#readme
源码仓库：https://github.com/ecorkran/context-forge

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

- 包体积（解压后）：193 kB，63 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=20\.18\.1
- 运行依赖：3 个
- 首次发布：2026-02-23T19:26:51.528Z
- 最新版本发布：2026-11-07T13:05:27.351Z
- 近 30 天下载量：3716（2026-10-11 至 2026-11-09，npm 官方下载统计）
- 已发布版本数：111（近 12 个月 111 个）

## 中文简介

Content Forge 的 MCP 服务器—— 从项目配置和模板生成结构化的 AI 上下文提示

## 安装

```sh
npm install @context-forge/mcp
```

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

## README

# @ context-forge/ mcp (英语)

生成结构化上下文的 MCP 服务器提示 AI 编码会话 。 配置您的工程一次, 然后每次您用 Claude 代码、 光标或任何 MCP 兼容工具启动新会话时, 都会生成新的、 一致的上下文 .

## 这是什么?

每个有成效的AI编码会从上下文开始:你正在研究什么项目,什么切片或任务是活跃的,什么公约会随之而来,最后一场会中发生了什么. 上下文 Forge 从您的工程配置和快速模板中自动组装上下文 .

这个MCP服务器将Context Forge的上下文引擎暴露为一组工具,你的AI助手可以直接调用. 助理不是手工复制和粘贴上下文块,而是按要求生成上下文块——随着工作的进展保持时尚.

## 为什么?

人工建筑是乏味的。 每个会话,你都拼凑出相同的作品:项目状态,当前的任务,编码惯例,模板部分. 它需要几分钟, 它容易出错, 它打破你的流量.

上下文Forge消除了这种头顶。 您配置您的项目一次——模板、 语句、 项目结构, 然后生成一个完整、 有条理的上下文, 用单个工具调用 。 当您切换切片,更改任务,或达到里程碑时,您的助手会更新工程状态并自动反映下一代上下文.

## 快速启动

### 安装

```bash
# Recommended: meta-package installs both MCP server and CLI
npm install -g @context-forge/context-forge

# Or install the MCP server alone
npm install -g @context-forge/mcp

# Or run directly (no install needed)
npx @context-forge/mcp
```

### Claude 代码配置

使用 Claude 代码 CLI 添加服务器 :

```bash
claude mcp add --transport stdio context-forge -- npx @context-forge/mcp
```

或手动添加到您的项目 `.mcp.json`数字 :

```json
{
  "mcpServers": {
    "context-forge": {
      "type": "stdio",
      "command": "npx",
      "args": ["@context-forge/mcp"]
    }
  }
}
```

### 光标配置

在您的光标 MCP 设置中添加以下内容( T)`.cursor/mcp.json` 在您的项目根中 :

```json
{
  "mcpServers": {
    "context-forge": {
      "command": "npx",
      "args": ["@context-forge/mcp"]
    }
  }
}
```

## 可用工具

### 代理方向

| 工具 | 说明 |
| --- | --- |
| `agent_onboard` | 新项目分步骤上岗配方. 在现有的编码库上,食谱在打印检测通知后停止,这说明 `sq onboard` |
| `agent_quickstart` | 机器消费者结构化能力计划(操作员,CI) |

### 项目管理

| 工具 | 说明 |
| --- | --- |
| `project_list` | 列出所有配置的带有摘要字段的项目 |
| `project_get` | 通过 ID (或默认项目) 获取完整的工程细节 |
| `project_create` | 创建新工程( 名称+ 路径要求) |
| `project_update` | 更新项目配置 。 设置 `developmentPhase` 自动集 `instruction`。 。 。 . `fileComprehension` (c) 登记密码库理解文件(已检查、已存储的根相; `""` (原始内容存档于2018-09-25). clears. |
| `project_schema` | 包含字段定义、别名、组和enum值的完整项目数据计划 |
| `project_structure` | 建立完整的项目模式(建立、倡议、切片、任务、今后的工作) |
| `project_detect` | 报告目录的内容以及适用何种收养结果。 只读;在未注册目录上工作. 见 [收养](https://npmcn.com/package/docs/ADOPTION-PRIMITIVES.md) |

### 背景生成

| 工具 | 说明 |
| --- | --- |
| `context_build` | 从工程配置生成完整的上下文提示 。 包括a `### Codebase Reference` 区域 当活动提示的配置列表 `fileComprehension` 或者说 `fileDocsMap`。 。 。 . |
| `context_summarize` | 更新项目会话状态( 最近的事件, 注释) |
| `template_preview` | 预览无副作用的上下文输出 |
| `prompt_list` | 列出项目可用的快速模板 |
| `prompt_get` | 获取特定快速模板的全部内容 |

### 工作流程

| 工具 | 说明 |
| --- | --- |
| `workflow_next` | 根据项目状况建议采取下一个行动 |
| `workflow_status` | 当前阶段、切片和任务进展 |
| `workflow_check` | 对项目文物进行一致性检查 |
| `workflow_future` | 所有切片计划的未来工作项目汇总 |

### 人工反射

| 工具 | 说明 |
| --- | --- |
| `introspection_documents` | 检测给定切片索引的哪些方法文件 |
| `introspection_frontmatter` | 从任何方法文档中提取 YAML 前题 |
| `introspection_slice_plan` | 分析包含条目、状态和完成计数的切片计划 |
| `introspection_tasks` | 以已完成状态、 总数和推断状态分析任务文件 |
| `introspection_future_work` | 从切片计划中分析未来工作部分 |

### 指南

| 工具 | 说明 |
| --- | --- |
| `guide_status` | 检查是否安装了 AI 项目指南 |
| `guide_install` | 安装方法指南 |
| `guide_update` | 更新到最新指南版本 |

### 工作树木

| 工具 | 说明 |
| --- | --- |
| `worktree_list` | 列出所有已注册的工作树背景 |
| `worktree_get` | 获取特定工作树的细节 |
| `worktree_init` | 创建一个有索引范围的新的工作树上下文 |
| `worktree_update` | 更新工作树字段 |
| `worktree_rm` | 删除工作树上下文 |

### 配置

| 工具 | 说明 |
| --- | --- |
| `config_get` | 获得配置密钥值( 密钥可以列出全部) |
| `config_set` | 在用户或项目范围设置配置值 |

### 元数据

| 工具 | 说明 |
| --- | --- |
| `server_version` | 服务器名称和版本 |
| `storage_backup` | 创建项目数据的版本备份 |

**提示 :** 设定 `default_project` 一次并省略 `projectId` 从所有其他工具调用 :

```
config_set key="default_project" value="project_1739..." scope="user"
```

关于完整的参数细节,见 [工具参考](https://npmcn.com/package/docs/TOOLS.md)。 。 。 .

## 先决条件

-   **节点.js 18+**
-   **项目指导模板** 在您的项目中设置

背景 Forge 使用来自 [项目指南](https://github.com/ecorkran/ai-project-guide)通过CLI安装:

```bash
npm install -g @context-forge/cli
cf init              # register project
cf guides install    # install methodology templates
```

见 [ai-项目指南存储库](https://github.com/ecorkran/ai-project-guide) 关于方法和模板系统的细节.

## 相关

-   [上下文福尔格](https://npmcn.com/package/README.md) ——有完整项目文件的单列波根
-   [代理集成指南](https://npmcn.com/package/docs/AGENT-INTEGRATION.md) 如何从人工智能代理人、指挥员和CI管道整合
-   [@ context-forge/ 核心](https://npmcn.com/package/%40context-forge/core/README.md) – 赋予此服务器权力的上下文生成引擎
-   [项目指南](https://github.com/ecorkran/ai-project-guide) 模板系统和项目方法

## 许可证

麻省理工学院

## 常见问题

### @context-forge/mcp 是什么？

Content Forge 的 MCP 服务器—— 从项目配置和模板生成结构化的 AI 上下文提示

### 如何安装 @context-forge/mcp？

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

### @context-forge/mcp 支持 TypeScript 吗？

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

### @context-forge/mcp 支持 ESM 还是 CommonJS？

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

### @context-forge/mcp 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=20\.18\.1。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @context-forge/mcp 可以商用吗？

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

### @context-forge/mcp 的下载量有多少？

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

### @context-forge/mcp 还在维护吗？

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