athena-mcp

当 Hermes 遇到困难时，它会求助于 Athena。

一个 MCP 服务器，为你的工具使用型智能体提供一个推理助手。只有一个工具：think。没有副作用——Athena 本身没有任何工具。她只负责推理。

当你的主智能体（Hermes、Claude Code、Cursor 或任何支持 MCP 的客户端）遇到难题时——比如微妙的 Bug、架构决策、需要评估的计划——它会调用 think 并获得一个简洁、逻辑严密的回复。你的智能体始终掌握主动权；Athena 是它在遇到难以处理的问题时求助的安静顾问。

灵感来源于 Codebuff 的 thinker agent，它在内部正是这样做的：Codebuff 的编排器在收集上下文后启动一个没有工具的 thinker-gpt，而该思考者的唯一任务就是深入思考并返回简短的答案。

为什么要分离？

大多数智能体在所有任务上都运行同一个模型。该模型是一种折中方案：既要足够快且便宜以应对数百次工具调用，又要足够聪明以处理大多数任务。但当它真正卡住时，你需要一个不同的模型——一个推理能力强的模型（Claude Opus、GPT-5、Gemini Pro、DeepSeek R1）——同时又不放弃对任务其余部分的控制。这就是 Athena 的用途。

• 成本 — 在每一步都运行推理模型非常昂贵。仅在需要时调用它们。

• 延迟 — 推理模型思考缓慢。将它们留给困难的问题。

• 工具正交性 — Athena 特意不配备任何工具。调用者始终控制副作用。

• 模型可移植性 — 无需重新配置整个智能体即可按需切换推理模型。

两种后端

claude-code（当 claude CLI 在 PATH 中时为默认值） — 每次调用都会启动 claude -p 并使用你的 Anthropic Pro/Max 订阅 OAuth。无需 API 密钥，无需按 Token 计费。仅计入你的订阅配额。支持 opus、sonnet、haiku 或完整的 Claude 模型名称。

openrouter — 通过 HTTPS 调用 OpenRouter。通过按 Token 计费使用任何模型（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 原生支持通过 stdio 进行 MCP 通信（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 客户端

这是一个标准的 stdio MCP 服务器。将你的客户端指向 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> 块 在 Athena 的响应中会在返回前被剥离——她可以将它们用作草稿空间而不会污染输出。符合 Codebuff 的约定。

• 中立的 cwd。 claude-code 后端从 os.tmpdir() 启动，因此项目中的 CLAUDE.md 文件不会泄露到 Athena 的上下文中。

• --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

致谢

模式借鉴自 CodebuffAI 团队的 Codebuff，在此表示感谢。他们的思考者智能体是此设计的权威参考。