How do I use EVE Online Companion MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@EVE Online Companion MCP Server what's the price of a Vexor Navy Issue in Jita?" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

de en es ja ko ru zh

EVE Online Companion MCP Server

by 32n1

Overview Schema Related Servers Score Discussions

TypeScript

Hybrid

EVE Online Companion — MCP Server

Ein MCP-Server (Model Context Protocol) fuer Claude Code, der als persoenlicher EVE Online Companion dient. Gibt Claude direkten Zugriff auf Character-Daten, Marktpreise, Killboard-Intel, Wiki-Wissen und mehr — alles ueber natuerliche Sprache.

Was kann das?

"Kann ich die Ishtar fliegen?" — Prueft deine Skills und zeigt fehlende mit Trainingszeit.

"Was kostet ein Warp Disruptor II in Jita?" — Holt Live-Marktdaten von ESI.

"Wie gefaehrlich ist der Pilot XY?" — Checkt zKillboard-Stats, Danger-Rating, Top-Ships.

"Zeig mir meine Fittings fuer die Vexor" — Listet gespeicherte Fits im EFT-Format.

"Erklaer mir Wormhole-Mechaniken" — Durchsucht die EVE University Wiki.

Alle 29 Tools

Kategorie	Tools	Beschreibung
Auth	`eve_auth_login`	SSO-Login (blockiert bis Callback)
	`eve_auth_start`	SSO-Login (non-blocking, oeffne localhost:8834)
	`eve_auth_status`	Auth-Status + Character-Info
Character	`eve_character_info`	Name, Corp, Alliance, Wallet, SP, Location, Ship
	`eve_character_skills`	Skills filtern nach Gruppe oder Name
	`eve_character_skillqueue`	Aktuelle Skill-Queue mit Zeiten
	`eve_character_implants`	Eingesteckte Implants
Location	`eve_location_current`	System, Station, Schiff, Online-Status
	`eve_route_plan`	Route berechnen (shortest/secure/insecure)
	`eve_set_destination`	Autopilot-Ziel im Spiel setzen
Fittings	`eve_fitting_list`	Gespeicherte Fittings (EFT-Format)
	`eve_fitting_save`	Fitting aus EFT-String speichern
	`eve_fitting_analyze`	Fitting-Analyse (Tank, DPS, Cap — Dogma-basiert)
Market	`eve_market_price`	Preis-Check (Jita default, andere Regionen moeglich)
	`eve_market_appraise`	Itemliste bewerten (Copy-Paste aus dem Spiel)
	`eve_market_orders`	Eigene aktive Kauf-/Verkaufsauftraege
Intel	`eve_intel_character`	Pilot-Intel: Corp, Kills, Danger-Rating, Top-Ships
	`eve_intel_corporation`	Corp-Intel: Members, Alliance, Killboard-Stats
	`eve_intel_system`	System-Intel: Kills, Jumps, NPC-Kills, Ratting
	`eve_killmail_analyze`	Killmail aufschluesseln: Fit, Attacker, Damage
Assets	`eve_assets_search`	Assets nach Name/Typ durchsuchen
	`eve_wallet_balance`	Wallet-Balance
	`eve_wallet_journal`	Letzte Wallet-Eintraege
Universe	`eve_type_info`	Item/Ship-Details mit Dogma-Attributen
	`eve_system_info`	System-Details: Sec, Region, Stationen
	`eve_search`	Universelle Suche (Chars, Corps, Systems, Items)
Wiki	`eve_wiki_search`	EVE University Wiki durchsuchen
	`eve_wiki_article`	Wiki-Artikel lesen (als Markdown)
Fleet	`eve_fleet_info`	Fleet-Status (wenn in Fleet)

Setup

1. EVE Developer Application

Gehe zu https://developers.eveonline.com/
"Create New Application"
Application Type: Authentication & API Access
Callback URL: http://localhost:8834/callback
Alle Scopes aus der Liste unten auswaehlen
Client ID notieren (Secret Key optional, nur fuer confidential apps)

esi-skills.read_skills.v1
esi-skills.read_skillqueue.v1
esi-clones.read_implants.v1
esi-assets.read_assets.v1
esi-wallet.read_character_wallet.v1
esi-fittings.read_fittings.v1
esi-fittings.write_fittings.v1
esi-characters.read_standings.v1
esi-killmails.read_killmails.v1
esi-location.read_location.v1
esi-location.read_ship_type.v1
esi-location.read_online.v1
esi-fleets.read_fleet.v1
esi-markets.read_character_orders.v1
esi-contracts.read_character_contracts.v1
esi-mail.read_mail.v1
esi-ui.open_window.v1
esi-ui.write_waypoint.v1
esi-search.search_structures.v1
esi-universe.read_structures.v1

2. Installation

git clone <repo>
cd eve
npm install
npm run build

3. Konfiguration

mkdir -p ~/.eve-mcp

Erstelle ~/.eve-mcp/config.json:

{
  "clientId": "deine-client-id-von-ccp",
  "callbackUrl": "http://localhost:8834/callback",
  "userAgent": "eve-mcp-companion/1.0 (dein-character-name)"
}

Optional mit Secret Key (nur bei confidential apps):

{
  "clientId": "deine-client-id",
  "secretKey": "dein-secret-key",
  "callbackUrl": "http://localhost:8834/callback",
  "userAgent": "eve-mcp-companion/1.0 (dein-character-name)"
}

Alternativ via Environment-Variablen:

export EVE_MCP_CLIENT_ID="deine-client-id"
export EVE_MCP_CALLBACK_URL="http://localhost:8834/callback"
export EVE_MCP_USER_AGENT="eve-mcp-companion/1.0"

4. Claude Code Integration

Fuege den MCP-Server in deine Claude Code Settings ein.

Option A — settings.json (empfohlen):

Datei: ~/.claude/settings.json

{
  "mcpServers": {
    "eve-online": {
      "command": "node",
      "args": ["/absoluter/pfad/zu/eve/dist/index.js"],
      "env": {
        "EVE_MCP_TOKEN_PASSPHRASE": "ein-sicheres-passwort"
      }
    }
  }
}

Option B — Projekt-scope (.mcp.json im Projektverzeichnis):

{
  "mcpServers": {
    "eve-online": {
      "command": "node",
      "args": ["./dist/index.js"],
      "env": {
        "EVE_MCP_TOKEN_PASSPHRASE": "ein-sicheres-passwort"
      }
    }
  }
}

Starte Claude Code und sage:

"Verbinde mich mit EVE Online"

Claude ruft eve_auth_start auf und startet einen lokalen Auth-Server. Oeffne http://localhost:8834 im Browser — dort erscheint eine Login-Seite im EVE-Stil. Klicke "Authenticate via EVE SSO", logge dich bei CCP ein, und du wirst zurueckgeleitet zu einer Erfolgsseite mit deinem Character-Portrait. Fenster schliessen, fertig.

Architektur

eve/
├── src/
│   ├── index.ts                 # Server-Entry, registriert alle Tools
│   ├── config.ts                # Laedt ~/.eve-mcp/config.json
│   ├── auth/
│   │   ├── scopes.ts            # ESI Scope-Definitionen
│   │   ├── sso.ts               # OAuth2 PKCE Flow, Callback-Server
│   │   ├── tokens.ts            # Token-Persistence (AES-256-GCM)
│   │   └── pages.ts             # HTML-Seiten fuer Auth-Flow
│   ├── clients/
│   │   ├── esi.ts               # ESI API Client (Auth, Rate-Limiting, Cache)
│   │   ├── zkillboard.ts        # zKillboard Client (10 req/s Throttle)
│   │   ├── evetycoon.ts         # EVE Tycoon Markt-Client
│   │   └── wiki.ts              # EVE University Wiki (MediaWiki API)
│   ├── tools/
│   │   ├── auth.ts              # Login, Status
│   │   ├── character.ts         # Character Info, Skills, Queue, Implants
│   │   ├── location.ts          # Location, Route, Autopilot
│   │   ├── fitting.ts           # Fittings, EFT, Analyse
│   │   ├── universe.ts          # Type Info, System Info, Search
│   │   ├── market.ts            # Preise, Appraisal, Orders
│   │   ├── killboard.ts         # Character/Corp/System Intel, Killmails
│   │   ├── assets.ts            # Assets, Wallet
│   │   ├── wiki.ts              # Wiki Search, Article
│   │   └── fleet.ts             # Fleet Info
│   └── utils/
│       ├── cache.ts             # In-Memory Cache mit TTL
│       ├── errors.ts            # Error-Klassen + formatToolError()
│       ├── formatting.ts        # ISK, Zeit, EVE-Time Formatierung
│       ├── eft.ts               # EFT-Format Parser + Generator
│       └── sde.ts               # Type/System Name-Resolution (ESI-backed)
├── package.json
├── tsconfig.json
└── README.md

API-Clients

Client	Base URL	Auth	Rate Limit	Cache
ESI	`esi.evetech.net/latest`	OAuth2 Bearer	Error-Limit Header	Expires-Header + custom TTL
zKillboard	`zkillboard.com/api`	keine	10 req/s	10 Minuten
EVE Tycoon	`evetycoon.com/api/v1`	keine	Expires-Header	5 Minuten
Wiki	`wiki.eveuniversity.org/api.php`	keine	keine	1 Stunde

Caching

Alle API-Antworten werden in-memory gecacht:

Datentyp	TTL
Location / Ship / Online	30 Sekunden
Wallet Balance	2 Minuten
Skill Queue	5 Minuten
Market Prices / Orders	5 Minuten
zKillboard Stats	10 Minuten
Assets	30 Minuten
Character Skills	1 Stunde
Wiki Articles	1 Stunde
Type Info / System Info	24 Stunden
Name-zu-ID Resolution	24 Stunden

ESI Rate-Limiting

Der ESI-Client trackt X-ESI-Error-Limit-Remain und X-ESI-Error-Limit-Reset Header. Wenn das Error-Limit unter 20 faellt, werden Requests bis zum Reset blockiert. Fehler 420 (Error Limit) werden als RateLimitError geworfen.

Token-Sicherheit

Tokens werden in ~/.eve-mcp/tokens.json gespeichert
Wenn EVE_MCP_TOKEN_PASSPHRASE gesetzt ist: AES-256-GCM Verschluesselung mit scrypt-Key-Derivation
Ohne Passphrase: Klartext-Speicherung (mit Warnung auf stderr)
Access-Token wird automatisch 2 Minuten vor Ablauf refreshed
Refresh-Token wird bei jedem Refresh erneuert (PKCE volatile token pattern)

Entwicklung

# Dev-Mode (tsx, kein Build noetig)
npm run dev

# Build
npm run build

# Ausfuehren
npm start

Neues Tool hinzufuegen

Handler in die passende Datei unter src/tools/ einfuegen
server.tool(name, description, zodSchema, handler) Pattern verwenden
Fehler immer mit formatToolError(err) zurueckgeben
ESI-Calls ueber esi.get() / esi.publicGet() mit passendem Cache-TTL
Type-IDs mit resolveTypeName() / resolveTypeId() aufloesen

Troubleshooting

"Config not found" — ~/.eve-mcp/config.json anlegen oder EVE_MCP_CLIENT_ID setzen.

"Authentication required" — eve_auth_login oder eve_auth_start aufrufen.

"Token refresh failed" — Refresh-Token abgelaufen. Erneut einloggen.

"ESI error limit reached" — Zu viele fehlerhafte Requests. Wartet automatisch.

Port 8834 belegt — Anderen Port in config.json setzen und Callback-URL bei CCP anpassen.

Install Server

security – no known vulnerabilities

license - not found

quality - A tier

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Latest Blog Posts

Tool Definition Quality Score (TDQS)
By punkpeye on April 3, 2026.
mcp
The Hackers Who Tracked My Sleep Cycle
By punkpeye on March 26, 2026.
security
Open Source Has a Bot Problem
By punkpeye on March 19, 2026.
open source

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/32n1/eveMCP'

If you have feedback or need assistance with the MCP directory API, please join our Discord server