athena-mcp

Когда Гермес застревает, он спрашивает Афину.

MCP-сервер, который дает вашему агенту, использующему инструменты, умного помощника. Один инструмент: think. Никаких побочных эффектов — у Афины нет собственных инструментов. Она только рассуждает.

Когда ваш основной агент (Hermes, Claude Code, Cursor или любой другой клиент MCP) сталкивается со сложной проблемой — тонким багом, архитектурным вопросом или планом, требующим критики, — он вызывает think и получает краткий, хорошо обоснованный ответ. Ваш агент остается за рулем; Афина — это тихий консультант, к которому он обращается, когда проблема оказывается сложнее, чем может решить его базовая модель.

Вдохновлено thinker-агентом Codebuff, который делает именно это внутри себя: оркестратор Codebuff запускает thinker-gpt без инструментов после сбора контекста, и единственная задача этого «мыслителя» — глубоко подумать и вернуть краткий ответ.

Зачем нужно разделение?

Большинство агентов работают на одной модели для всего. Эта модель — компромисс: достаточно быстрая и дешевая для сотен вызовов инструментов, достаточно умная для большинства из них. Но когда агент действительно застревает, вам нужна другая модель — ориентированная на глубокие рассуждения (Claude Opus, GPT-5, Gemini Pro, DeepSeek R1), — при этом не передавая ей контроль над остальной частью задачи. Именно для этого нужна Афина.

• Стоимость — модели рассуждения дороги в использовании при каждом запросе. Вызывайте их только тогда, когда это необходимо.

• Задержка — модели рассуждения думают медленно. Приберегите их для сложных задач.

• Ортогональность инструментов — у Афины намеренно нет инструментов. Вызывающий агент сохраняет контроль над побочными эффектами.

• Портативность моделей — меняйте модели рассуждения для каждого вызова без перенастройки всего агента.

Два бэкенда

claude-code (по умолчанию, если claude CLI находится в PATH) — запускает claude -p для каждого вызова и использует ваш OAuth Pro/Max подписки Anthropic. Никаких API-ключей, никакой оплаты за токены. Просто расходует квоту вашей подписки. Поддерживает opus, sonnet, haiku или полные названия моделей Claude.

openrouter — HTTPS-запрос к OpenRouter. Любая модель (Claude, GPT, Gemini, DeepSeek, Qwen и т.д.) с оплатой за токены. Требует OPENROUTER_API_KEY.

Выбирайте явно с помощью ATHENA_BACKEND=claude-code или ATHENA_BACKEND=openrouter.

Установка

git clone https://github.com/DevvGwardo/athena-mcp.git ~/projects/athena-mcp
cd ~/projects/athena-mcp
npm install
npm run build

Окружение

Подключение к Hermes

Hermes поддерживает MCP через stdio нативно (Nous Research Hermes Agent).

С подпиской Claude (рекомендуется):

hermes mcp add athena \
  --command /path/to/node \
  --args /path/to/athena-mcp/dist/index.js \
  --env ATHENA_CLAUDE_CLI=/opt/homebrew/bin/claude

С OpenRouter:

hermes mcp add athena \
  --command /path/to/node \
  --args /path/to/athena-mcp/dist/index.js \
  --env ATHENA_BACKEND=openrouter OPENROUTER_API_KEY=sk-or-v1-... ATHENA_MODEL=anthropic/claude-opus-4.6

Проверка:

hermes mcp list          # should show `athena`
hermes mcp test athena   # should report "Connected" and 1 tool

Запустите новую сессию Hermes, и агент увидит инструмент think.

Подключение к Claude Code

claude mcp add athena --command node --args /path/to/athena-mcp/dist/index.js

Подключение к любому другому MCP-клиенту

Это стандартный MCP-сервер stdio. Укажите клиенту путь node /path/to/athena-mcp/dist/index.js.

Инструмент think

Пример вызова (JSON-RPC):

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "think",
    "arguments": {
      "prompt": "Is there a race condition in the claim() function? If so, minimal fix?",
      "context": "def claim(self, rid):\n    if self.claims.get(rid):\n        return False\n    self.claims[rid] = self.agent_id\n    return True",
      "effort": "high"
    }
  }
}

Ответ возвращается в виде текста с нижней строкой: backend: ... · model: ... · effort: ... · duration · tokens.

Заметки по проектированию

• Без состояния. Каждый вызов независим. Для непрерывности разговора передавайте соответствующую историю через context.

• Блоки <think>...</think> в ответе Афины удаляются перед возвратом — она может использовать их как черновик, не засоряя вывод. Соответствует соглашению Codebuff.

• Нейтральный cwd. Бэкенд claude-code запускается из os.tmpdir(), поэтому файлы CLAUDE.md проекта не попадают в контекст Афины.

• --tools "" + --disable-slash-commands + --no-session-persistence при каждом вызове claude-code гарантируют, что она действительно остается без инструментов и без состояния.

• Нет логики повторных попыток. Если бэкенд выдает ошибку, она передается вызывающему агенту, который сам решает, стоит ли повторять попытку.

Разработка

npm run dev     # tsc --watch
npm run build
npm start       # runs dist/index.js (needs an MCP stdio peer)

Дымовое тестирование без обращения к API:

printf '%s\n' \
  '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"t","version":"0"}}}' \
  '{"jsonrpc":"2.0","method":"notifications/initialized"}' \
  '{"jsonrpc":"2.0","id":2,"method":"tools/list"}' \
  | node dist/index.js

Лицензия

MIT

Авторы

Паттерн заимствован — с признательностью — у Codebuff от команды CodebuffAI. Их thinker-агент является каноническим эталоном для этого дизайна.