Agent Forge MCP в Cursor

AgentForge.Mcp — stdio MCP-сервер к HTTP API forge. Токен берётся из ~/.forge/credentials.json (после forge auth login) или из FORGE_API_TOKEN.

1. Forge API должен быть запущен

Рекомендуется (Docker): см. local-dev-docker.md

cd agent-forge
.\scripts\docker-up.ps1

Альтернатива без Docker: dotnet run --project src\AgentForge\AgentForge.csproj

Проверка: http://127.0.0.1:8770/health

2. Опубликовать MCP

.\scripts\publish-mcp.ps1

По умолчанию: сборка в publish-mcp/ и зеркало D:\agent-forge-mcp\AgentForge.Mcp.exe.

Без зеркала: .\scripts\publish-mcp.ps1 -Target ""

3. Добавить в Cursor

Cursor Settings → MCP → добавить сервер. Фрагмент: mcp-cursor-example.json.

{
  "mcpServers": {
    "forge": {
      "command": "D:\\agent-forge-mcp\\AgentForge.Mcp.exe",
      "env": {
        "FORGE_BASE_URL": "http://127.0.0.1:8770"
      }
    }
  }
}

Переменные (опционально):

Env	Назначение
`FORGE_BASE_URL`	URL forge (default `http://127.0.0.1:8770`)
`FORGE_API_TOKEN`	Bearer, если нет `~/.forge/credentials.json`
`FORGE_ACTOR`	Identity на все write (`oar:Comet`) — заголовок `X-Forge-Actor`

Инструменты

list_repos, create_repo, get_repo, … — полный список и схемы: GET /api/v1/capabilities → tools[] (MCP ListTools зеркалит это при старте bridge).

Два агента (два окна Cursor)

Разные MCP entry с разным FORGE_ACTOR — см. pilot-two-agents-cursor.md.

Альтернатива: Cascade IDE

Forge Lens из открытого файла в CIDE: ide_forge_lens_* через CascadeIDE --mcp-stdio (тяжелее, нужна IDE). Для headless pilot достаточно AgentForge.Mcp.