@context-forge/mcp

中文文档
0.19.26发布于 2026/11/07MITTypeScriptES Module近 30 天下载 3716

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

中文使用文档
文档目录19 节
  1. 这是什么?
  2. 为什么?
  3. 快速启动
  4. 安装
  5. Claude 代码配置
  6. 光标配置
  7. 可用工具
  8. 代理方向
  9. 项目管理
  10. 背景生成
  11. 工作流程
  12. 人工反射
  13. 指南
  14. 工作树木
  15. 配置
  16. 元数据
  17. 先决条件
  18. 相关
  19. 许可证

@ context-forge/ mcp (英语)

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

这是什么?

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

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

为什么?

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

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

快速启动

安装

# 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 添加服务器 :

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

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

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

光标配置

在您的光标 MCP 设置中添加以下内容( T).cursor/mcp.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报告目录的内容以及适用何种收养结果。 只读;在未注册目录上工作. 见 收养

背景生成

工具说明
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"

关于完整的参数细节,见 工具参考。 。 。 .

先决条件

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

背景 Forge 使用来自 项目指南通过CLI安装:

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

见 ai-项目指南存储库 关于方法和模板系统的细节.

许可证

麻省理工学院

版本与发布记录

@context-forge/mcp 共发布 111 个版本,首次发布于 2026/02/24;过去 12 个月发布了 111 个版本。

版本发布日期距今
0.19.26latest2026/11/073 天前
0.19.252026/11/046 天前
0.19.242026/11/019 天前
0.19.232026/10/3011 天前
0.19.222026/10/3012 天前
0.19.212026/10/2714 天前

关于 @context-forge/mcp 的常见问题

@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 和提交记录判断。