eve-mentor-mcp

An MCP server that turns Claude into an EVE Online mentor for players trying to learn the game.

EVE has the steepest learning cliff in gaming. Existing tools assume you already know what to ask. This one is built around the questions new players actually have:

• "Why do I keep getting blown up?" — pulls your real losses from zKillboard with the full fit you were flying, who killed you, and with what, so Claude can explain exactly what went wrong.
• "Is this system dangerous?" — live kill and traffic data for any system.
• "What is this thing and what does it cost?" — any ship or module, with live Jita prices.
• "What should I do next?" — log in with EVE SSO and Claude sees your skills, skill queue, wallet, location, and current ship, and can coach from your actual situation.

Works with Claude Desktop, Claude Code, and any MCP client.

Tools

Install (no coding required)

You need two things: the Claude Desktop app (or Claude Code) and Node.js, a free runtime that this server runs on — installing it is like installing any other app.

Step 1 — Install Node.js (skip if you have it)

Go to nodejs.org, download the LTS version, run the installer, click through with the defaults. Done.

Step 2 — Tell Claude about it (no download needed)

Claude Desktop: open the config file in any text editor —

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

(If it doesn't exist, create it.) Make it look like this:

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

Save, then fully quit and reopen Claude Desktop. That's it — npx downloads and runs the server automatically; updates come free.

Claude Code (one line instead):

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

Step 3 — Test it

Ask Claude: "Pull the last 3 losses for character <any EVE character name> and explain what went wrong." If it answers with real killmail data, you're live. No EVE login is needed for this — losses, system intel, prices, the career test, and the jargon glossary all work immediately.

Other AI apps

Any MCP-capable client works the same way (Cursor, LM Studio, VS Code, etc. — point them at node /path/dist/index.js). ChatGPT supports MCP but only remote servers, not local ones — a hosted version of the public tools is on the roadmap.

Character tools (EVE SSO)

1. Go to developers.eveonline.com → log in with your EVE account → Create New Application
2. Name it anything (e.g. eve-mentor), pick Authentication & API Access
3. Select these scopes:
   • 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. Set the callback URL to exactly https://ruby-eve.com/callback — CCP's portal only accepts https callbacks; this static page (source in site/callback/) relays the login code to the local server on port 8484. (Self-hosting? Serve your own copy and set EVE_REDIRECT_URI.)
5. Copy the Client ID and add it to the server's environment:

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

(or add "env": {"EVE_CLIENT_ID": "your_client_id"} to the Claude Desktop config.)

Then ask Claude to log you in to EVE — a browser opens, you authorize, done. Tokens are stored in ~/.config/eve-mentor/tokens.json (mode 600) and refresh automatically.

Try it

"Pull my last 3 losses for character Your Pilot Name and explain what I did wrong in each one."

"I'm about to fly through Tama. How dangerous is it right now?"

"What should I be training next given my skills and the fact that I want to try small-gang PvP?"

Verify it works

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

Notes

• Data comes from ESI (CCP's official API) and zKillboard. Be a good citizen: this server sends a proper User-Agent and caches name lookups.
• Built under the CCP Developer License — non-commercial, as required.
• EVE Online and all related trademarks are the property of CCP hf.

Roadmap

All five feature releases (v0.1–v0.5) are shipped — loss analysis, "can I fly it?", career sorting hat, fitting & combat coaching, direction & ISK guidance, pilot memory, and safety/logistics/news. What's left is distribution:

• Registry submissions (official MCP registry, Smithery, Glama) and CCP's third-party directory
• Remote MCP deployment so no local install is needed (and ChatGPT support)

Full detail in ROADMAP.md. PRs welcome. MIT licensed.