eve-mentor-mcp

eve-mentor-mcp

Claude を、ゲームを学ぼうとしているプレイヤーのための EVE Online メンターにする MCP サーバーです。

EVE の学習曲線は、ゲームの中でも最も険しいものです。既存のツールは、何を質問すればよいかをすでに知っていることを前提としています。このツールは、新規プレイヤーが実際に抱く疑問を中心に設計されています。

• 「どうして何度も撃墜されるの？」 — zKillboard から実際の損失を取得します。搭乗していた艦の完全なフィッティング、撃墜した相手、その手段も確認できるため、Claude が何が問題だったのかを正確に説明できます。
• 「このシステムは危険？」 — どのシステムについても、キル数と通行量のライブデータを確認できます。
• 「これは何で、いくらするの？」 — あらゆる艦船やモジュールについて、Jita のライブ価格を確認できます。
• 「次は何をすればいい？」 — EVE SSO でログインすると、Claude がスキル、スキルキュー、ウォレット、現在地、搭乗中の艦船を確認し、実際の状況に基づいてアドバイスできます。

Claude Desktop、Claude Code、あらゆる MCP クライアントで動作します。

ツール

インストール（コーディング不要）

必要なのは、Claude Desktop アプリ（または Claude Code）と Node.js の2つです。Node.js はこのサーバーの実行に使う無料のランタイムで、ほかのアプリと同じようにインストールできます。

ステップ 1 — Node.js をインストールする（インストール済みの場合はスキップ）

nodejs.org にアクセスし、LTS バージョンをダウンロードしてインストーラーを実行し、既定の設定のまま進めます。 これで完了です。

ステップ 2 — Claude に設定する（ダウンロードは不要）

Claude Desktop： 任意のテキストエディターで設定ファイルを開きます —

• Mac：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

（存在しない場合は作成してください。）次のように設定します。

{
  "mcpServers": {
    "eve-mentor": {
      "command": "npx",
      "args": ["-y", "eve-mentor-mcp"]
    }
  }
}

保存したら、Claude Desktop を完全に終了してから再起動します。これで完了です — npx がサーバーを自動的にダウンロードして実行します。アップデートも自動で適用されます。

Claude Code の場合は、代わりに次の 1 行を実行します。

claude mcp add eve-mentor -- npx -y eve-mentor-mcp

git clone https://github.com/henryjrobinson/eve-mentor-mcp
cd eve-mentor-mcp
npm install && npm run build

ステップ 3 — 動作を確認する

Claude に次のように尋ねます：「キャラクター <任意のEVEキャラクター名> の直近 3 件の敗北を取得して、何が問題だったか説明して。」 実際のキルメールデータを使って回答すれば、準備完了です。この確認に EVE へのログインは不要です — 敗北、システム情報、価格、キャリアテスト、専門用語集はすべてすぐに利用できます。

その他の AI アプリ

MCP 対応クライアントなら、どれでも同じ方法で使えます（Cursor、LM Studio、VS Code など — node /path/dist/index.js を指定してください）。ChatGPT は MCP に対応していますが、リモートサーバーのみで、ローカルサーバーには対応していません — 公開ツールのホスト版は今後のロードマップに含まれています。

キャラクターツール（EVE SSO）

1. developers.eveonline.com にアクセス → EVE アカウントでログイン → Create New Application
2. 任意の名前を付け（例：eve-mentor）、Authentication & API Access を選択します
3. 次のスコープを選択します：
   • esi-skills.read_skills.v1
   • esi-skills.read_skillqueue.v1
   • esi-location.read_location.v1
   • esi-location.read_ship_type.v1
   • esi-wallet.read_character_wallet.v1
   • esi-assets.read_assets.v1
4. コールバック URL を正確に https://ruby-eve.com/callback に設定します — CCP のポータルが受け付けるのは HTTPS コールバックのみです。この静的ページ（ソースは site/callback/）がログインコードをポート 8484 のローカルサーバーに中継します。（セルフホストする場合は、独自のコピーを配信して EVE_REDIRECT_URI を設定してください。）
5. Client ID をコピーし、サーバーの環境に追加します：

claude mcp add eve-mentor -e EVE_CLIENT_ID=your_client_id -- npx -y eve-mentor-mcp

（または、Claude Desktop の設定に "env": {"EVE_CLIENT_ID": "your_client_id"} を追加します。）

その後、Claude に EVE へのログインを依頼します — ブラウザーが開き、認証すれば完了です。トークンは ~/.config/eve-mentor/tokens.json（モード 600）に保存され、自動的に更新されます。

試してみる

「キャラクター Your Pilot Name の直近 3 件の敗北を取得して、それぞれで何を間違えたのか説明して。」

「これから Tama を通過する予定です。今の危険度はどのくらいですか？」

「スキルと、小規模艦隊の PvP に挑戦したいという希望を踏まえると、次に何を訓練すべきですか？」

動作を確認する

npm run smoke                      # tests ESI name resolution, market, system intel
npm run smoke -- "Pilot Name"      # also tests the zKillboard loss pipeline

注意事項

• データは ESI（CCP の公式 API）と zKillboard から取得します。適切な利用を心がけてください。このサーバーは適切な User-Agent を送信し、名前の検索結果をキャッシュします。
• CCP Developer License に基づいて開発されており、規定に従い非商用です。
• EVE Online および関連するすべての商標は、CCP hf の所有物です。

ロードマップ

5 つの機能リリース（v0.1–v0.5）はすべて公開済みです — 敗北分析、「この船に乗れるか？」、キャリア診断、装備と戦闘のコーチング、進路と ISK のガイダンス、パイロットの記憶、安全性・ロジスティクス・ニュースに対応しています。残っているのは配布です：

• レジストリへの登録（公式 MCP レジストリ、Smithery、Glama）と CCP のサードパーティディレクトリへの掲載
• リモート MCP のデプロイにより、ローカルインストールを不要にする（および ChatGPT に対応する）

詳細は ROADMAP.md をご覧ください。PR を歓迎します。MIT ライセンスです。