@ai-kod/mcp

Stdio-сервер Model Context Protocol, предоставляющий инструментам (IDE, агенты) доступ к возможностям оркестратора AI-KOD.

Быстрый старт

npx @ai-kod/mcp@latest

Перед запуском настройте переменные окружения:

| Переменная | Назначение | Значение по умолчанию | | --------------------- | ------------------------------------------------ | --------------------------------| | CLIENT_BASE_URL | Базовый URL API оркестратора | http://localhost:3001 | | CLIENT_TOKEN | (опционально) токен доступа к API | — | | CLIENT_TIMEOUT_MS | Таймаут HTTP-запросов | 30000 |

Полный список переменных и их назначение — в .memory-bank/guides/environment.md.

CLI запускает stdio-транспорт из @modelcontextprotocol/sdk v1 — убедитесь, что клиент MCP поддерживает MCP 1.0.
Дополнительно можно указывать настройки через CLI/IDE, поддерживающие MCP (например VS Code MCP bridge).

Возможности

• Запуск и управление workflow’ами (pause/resume/stop).
• Получение паспортов, шагов и execution-записей задач.
• Потоковое чтение логов (поддержка heartbeat, лимитов tail) и globalevent событий.
• Ресурсы ai-kod://* для реестра задач и событий.

Разработка

pnpm --filter "@ai-kod/mcp" dev   # hot reload
pnpm --filter "@ai-kod/mcp" build # сборка в dist/
pnpm --filter "@ai-kod/mcp" test  # Vitest-юниты

Публикация

pnpm --filter "@ai-kod/mcp" test # (optional)
pnpm --filter "@ai-kod/mcp" build
pnpm --filter "@ai-kod/mcp" run release

Перед публикацией убедитесь, что версия package.json увеличена, а dist/ содержит актуальные артефакты.

Для группового релиза @ai-kod/api-client, @ai-kod/command-registry и MCP сервера используйте pnpm run release:mcp.