AgentForge

agentforge-mcp 是 AgentForge 的 Model Context Protocol 服务。一个工具，只做一件事：把模糊的需求变得清晰。

为什么

你肯定熟悉这个循环：你让编码 Agent 做点什么，它误解了你没说清楚的部分；你纠正它，它又弄坏了别的东西；你只好重新解释。解决办法不是换一个更聪明的 Agent，而是写出更清晰的提示词。

AgentForge 为你处理提示词工程。给它一句 "add a dark mode toggle that persists"，它就会：

• 提取真正的需求——包括边缘情况、验收标准，以及你可能忘记提及的事项；
• 针对你的特定 Agent 格式化——Claude Code 需要文件:行号引用，Cursor 需要指令，Aider 需要精简的上下文；
• 返回前检查质量——每条提示词都会经过 12 个维度的评分，然后才会离开引擎。

Harness 工程正当其时，但在编码 Agent 时代，提示词工程只会更加重要。在 1,000+ 个真实编码案例中进行测试后，使用 AgentForge 的项目达到可部署状态的速度快了 147%。

快速开始

无需安装——通过 npx 运行。

1. 获取 API key。 登录 agentforge.sciscale.org，打开 API keys， 然后创建一个。密钥只会显示一次——请复制保存。

2. 将其添加到你的 Agent。

Claude Code：

claude mcp add agentforge --env AGENTFORGE_API_KEY=af_your_key -- npx -y agentforge-mcp

Cursor / Windsurf / Claude Desktop——添加到你的 MCP 配置中 （~/.cursor/mcp.json、~/.codeium/windsurf/mcp_config.json 等）：

{
  "mcpServers": {
    "agentforge": {
      "command": "npx",
      "args": ["-y", "agentforge-mcp"],
      "env": { "AGENTFORGE_API_KEY": "af_your_key" }
    }
  }
}

3. 开始使用。 用自然的方式向 Agent 提问——“用 AgentForge 优化这条提示词，然后实现它：添加一个可持久保存的深色模式切换开关。”

工具 — agentforge_refine_prompt

参数	默认值
request	—	用普通语言描述你的任务（1–4000 个字符）。粗略描述也可以。
target_tool	claude-code	claude-code、codex、cursor、aider、continue、windsurf、kimi、generic
style	plan-first	plan-first、direct-edit、explore-first

返回优化后的提示词、质量引擎评分，以及你当天剩余的使用次数。

免费版与 Pro 版

	免费版	Pro 版
优化次数	每天 3 次	不限次数
质量引擎	按 12 个维度评分	评分并自动优化，直到通过 ≥ 90 分

或者使用 Web 应用

不想配置 MCP 服务？同一套引擎——相同的质量引擎、相同的按账户提供的 Pro 功能——可直接在浏览器中使用，地址为 agentforge.sciscale.org。无需安装、无需密钥、无需配置。

粘贴需求，选择目标工具，复制提示词——还包括生成历史记录和高级模式：

工作原理

agentforge-mcp 是一个轻量客户端——此软件包不包含引擎逻辑。你的需求会发送到 AgentForge API，由托管引擎完成提取、格式化和质量检查，然后返回提示词。引擎会持续改进，你无需更新此软件包。

Configuration

Variable	Default
AGENTFORGE_API_KEY	—	Required. Your API key.
AGENTFORGE_API_URL	https://agentforge.sciscale.org/api/v1/refine	Override the endpoint (rarely needed).

Develop

npm install
npm run build      # tsc -> dist/
node dist/index.js # runs on stdio

License

MIT — see LICENSE.