AgentForge
Turn rough requests into rigorously structured prompts, for any coding agent.
التثبيت
أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: .cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).
agentforge-mcpclaude mcp add agentforge -e 'AGENTFORGE_API_KEY=<your agentforge_api_key>' -e 'AGENTFORGE_API_URL=https://agentforge.sciscale.org' -- npx -y agentforge-mcp@0.1.4
{
"mcpServers": {
"agentforge": {
"command": "npx",
"args": [
"-y",
"agentforge-mcp@0.1.4"
],
"env": {
"AGENTFORGE_API_KEY": "<your agentforge_api_key>",
"AGENTFORGE_API_URL": "https://agentforge.sciscale.org"
}
}
}
}
متغيرات البيئة
AGENTFORGE_API_KEYإلزامي سري Your AgentForge API key from https://agentforge.sciscale.org/account/keysAGENTFORGE_API_URLAgentForge API base URL (defaults to https://agentforge.sciscale.org)
التوثيق
مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.
المحتويات
agentforge-mcp
Stop re-explaining what you want to your AI coding agent.
Hand it one rough sentence — get back a structured, tool-tuned prompt it can execute in one pass.
**agentforge.sciscale.org** · Quick start · npm
agentforge-mcp is the Model Context Protocol
server for AgentForge. One tool, one job: turn
a vague request into a sharp one.
Why
You know the loop: you ask your coding agent for something, it misreads the half you didn't spell out, you correct it, it breaks something else, you re-explain. The fix isn't a smarter agent — it's a sharper prompt.
AgentForge does the prompt engineering for you. Give it
"add a dark mode toggle that persists" and it:
- extracts the real requirements — the edge cases, the acceptance criteria, the things you'd have forgotten to mention;
- formats for your specific agent — Claude Code wants file:line references, Cursor wants directives, Aider wants tight context;
- quality-checks before returning — every prompt is scored across 12 dimensions before it leaves the engine.
Harness engineering is having a moment — but prompt engineering matters more in the coding-agent era, not less. Tested across 1,000+ real coding cases, projects with AgentForge in the loop reached a deployable state 147% faster.
Quick start
No install — it runs through npx.
1. Get an API key. Sign in at agentforge.sciscale.org, open API keys, and create one. The key is shown once — copy it.
2. Add it to your agent.
Claude Code:
claude mcp add agentforge --env AGENTFORGE_API_KEY=af_your_key -- npx -y agentforge-mcp
Cursor / Windsurf / Claude Desktop — add to your MCP config
(~/.cursor/mcp.json, ~/.codeium/windsurf/mcp_config.json, etc.):
{
"mcpServers": {
"agentforge": {
"command": "npx",
"args": ["-y", "agentforge-mcp"],
"env": { "AGENTFORGE_API_KEY": "af_your_key" }
}
}
}
3. Use it. Ask your agent naturally — "refine this with AgentForge, then build it: add a dark mode toggle that persists."
The tool — agentforge_refine_prompt
| Argument | Default | |
|---|---|---|
request | — | Your task in plain language (1–4000 chars). Rough is fine. |
target_tool | claude-code | claude-code, codex, cursor, aider, continue, windsurf, kimi, generic |
style | plan-first | plan-first, direct-edit, explore-first |
Returns the refined prompt, plus its Quality Engine score and your remaining daily usage.
Free vs Pro
| Free | Pro | |
|---|---|---|
| Refinements | 3 / day | Unlimited |
| Quality Engine | scored across 12 dimensions | scored + auto-refined until it passes ≥ 90 |
Or use the web app
Don't want to wire up an MCP server at all? The same engine — same Quality Engine, same per-account Pro — runs right in your browser at agentforge.sciscale.org. No install, no key, no config.
→ Try it now at agentforge.sciscale.org
Paste a request, pick your target tool, copy the prompt — generation history and advanced modes included:
How it works
agentforge-mcp is a thin client — no engine logic ships in this package. Your
request goes to the AgentForge API, the hosted engine does the extraction,
formatting, and quality-checking, and the prompt comes back. The engine keeps
improving without you ever updating this package.
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.
agentforge-mcp is part of AgentForge — a SciScale studio product.
الأسئلة الشائعة
ما هو AgentForge؟
Turn rough requests into rigorously structured prompts, for any coding agent.
كيف أثبّت AgentForge؟
يعمل على جهازك. في Claude Code: claude mcp add agentforge -e 'AGENTFORGE_API_KEY=<your agentforge_api_key>' -e 'AGENTFORGE_API_URL=https://agentforge.sciscale.org' -- npx -y agentforge-mcp@0.1.4. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.
هل يحتاج AgentForge إلى مفتاح API؟
نعم. يتطلب AGENTFORGE_API_KEY، وتضبطها في إعداداته.
هل AgentForge مفتوح المصدر؟
نعم. شيفرته متاحة على GitHub بترخيص MIT.
من يصون AgentForge؟
ينشره sciscale-studio. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.
من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.