eve-online-traffic-mcp

EVE Online Traffic MCP Server

⚠️ Beta Version Notice
This project is currently in beta development. Features may be incomplete, unstable, or subject to significant changes. Use at your own discretion and expect potential breaking changes in future updates.

A comprehensive Model Context Protocol (MCP) server for EVE Online traffic, navigation, and system information using both the official ESI API and SDE data.

Features

This MCP server provides comprehensive tools for EVE Online data access:

Name ↔ ID Conversion

Solar System Name to ID: Convert solar system names to IDs for route calculation
Station Name to ID: Convert station names to IDs for destination planning
Region Name to ID: Convert region names to IDs for regional analysis
Universal Name to ID: Convert any EVE Online entity names to IDs (systems, stations, regions, corporations, alliances, etc.)

System Information & Analysis

Solar System Info: Get comprehensive system information from both ESI and SDE APIs
Stargate Info: Get stargate connections and detailed information
System Connection Map: Generate connection maps showing stargate links between systems

Data Sources

ESI API: Real-time data from the official EVE Online API
SDE API: Static data export for comprehensive universe information
Automatic Name Resolution: All IDs are automatically resolved to names (e.g., "30000142 (Jita)")
Data Integration: Combines ESI and SDE data for maximum information coverage

API Dependencies

1. EVE Swagger Interface (ESI)

URL: https://esi.evetech.net/meta/openapi-3.0.json

ESIは、EVE Onlineの公式APIです。プレイヤーデータ、キャラクター情報、コーポレーション情報、マーケットデータなど、ゲーム内の様々な情報にアクセスできます。

2. Static Data Export (SDE) - Jita.Space

URL: https://sde.jita.space/latest/swagger.json
ベースURL: https://sde.jita.space/latest

SDE（Static Data Export）は、EVE Onlineのゲーム内静的データを提供するサードパーティAPIです。jita.spaceによって提供されており、アイテム情報、星系データ、NPC情報などの静的データにアクセスできます。

3. EVE-KILL API

URL: https://eve-kill.com/_openapi.json
ベースURL: https://eve-kill.com

EVE-KILLは、EVE Onlineのキルメール追跡と分析を行うモダンなアプリケーションです。アライアンス、キャラクター、コーポレーション、バトル、キルメール、キャンペーンなどの包括的なデータにアクセスできるAPIを提供しています。

Installation

Installing via Smithery

To install eve-online-traffic-mcp for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @kongyo2/eve-online-traffic-mcp --client claude

Manual Installation

git clone https://github.com/kongyo2/eve-online-traffic-mcp.git
cd eve-online-traffic-mcp
npm install

Recommended: MCP Sequential Thinking Tools

For enhanced analysis and complex EVE Online queries, we recommend using this server alongside MCP Sequential Thinking Tools. This combination allows for sophisticated multi-step analysis of EVE Online data, route planning, and strategic decision-making through structured thinking processes.

Usage

Development Mode

Start the server in development mode with interactive CLI:

npm run dev

Production Mode

Start the server for production use:

npm run start

Build

Compile TypeScript to JavaScript:

npm run build

Usage Notes

Language Recommendations for LLM Instructions

When providing instructions to LLMs connected to this MCP server, we recommend using English names for EVE Online entities (solar systems, stations, regions, corporations, etc.) for optimal results. The server's name resolution system is primarily designed around English entity names, and using English ensures better accuracy and consistency in data retrieval.

Examples:

✅ Use: "Jita", "Amarr", "The Forge"
❌ Avoid: Localized names in other languages

Available Tools

Name to ID Conversion Tools

`solar_system_name_to_id`

Convert solar system names to their IDs.

Parameters:

systemNames: Array of solar system names (max 500)

Example:

{
  "systemNames": ["Jita", "Amarr", "Dodixie"]
}

`station_name_to_id`

Convert station names to their IDs.

Parameters:

stationNames: Array of station names (max 500)

`region_name_to_id`

Convert region names to their IDs.

Parameters:

regionNames: Array of region names (max 500)

`universal_name_to_id`

Convert any EVE Online entity names to their IDs.

Parameters:

names: Array of entity names (max 500)

Supported Entity Types:

Solar Systems, Stations, Regions, Constellations
Corporations, Alliances, Characters, Factions
Inventory Types, Agents

System Information Tools

`solar_system_info`

Get comprehensive solar system information from both ESI and SDE APIs.

Parameters:

systemIds: Array of solar system IDs (max 100)

Returns:

System name, security status, security class
Constellation and region information (with names)
3D coordinates, star information
Stargates, stations, planets with names
Data source information (ESI/SDE)

Example:

{
  "systemIds": [30000142, 30002187]
}

`stargate_info`

Get detailed stargate information and connections.

Parameters:

stargateIds: Array of stargate IDs (max 50)

Returns:

Stargate name and position
Source and destination system information
Connection details with names

`system_connection_map`

Generate connection maps showing stargate links between systems.

Parameters:

systemIds: Array of solar system IDs (max 50)

Returns:

System security status and name
All outbound connections with stargate pairs
Destination system names

Example:

{
  "systemIds": [30000142]
}

Route Calculation Tools

`calculate_route`

Calculate the shortest route between two EVE Online solar systems.

Parameters:

origin: Origin solar system name or ID
destination: Destination solar system name or ID
flag: (Optional) shortest (default), secure, or insecure
avoidSystems: (Optional) Array of system names or IDs to avoid

Example:

{
 "origin": "Jita",
 "destination": "Amarr",
 "flag": "secure"
}

`calculate_multiple_routes`

Calculate routes from one origin to multiple destinations.

Parameters:

origin: Origin solar system name or ID
destinations: Array of destination system names or IDs (max 20)
flag: (Optional) shortest (default), secure, or insecure
avoidSystems: (Optional) Array of system names or IDs to avoid

Example:

{
 "origin": "Jita",
 "destinations": ["Amarr", "Dodixie", "Rens"],
}

`find_systems_in_range`

Find all solar systems within a specified jump range from an origin system.

Parameters:

origin: Origin solar system name or ID
maxJumps: Maximum number of jumps (1-10)
flag: (Optional) shortest (default), secure, or insecure
avoidSystems: (Optional) Array of system names or IDs to avoid

Example:

{
 "origin": "Jita",
 "maxJumps": 5
}

Available Prompts

`eve-entity-lookup`

Generate a summary of EVE Online entities with their IDs.

`eve-system-analysis`

Analyze solar system information and connections with detailed traffic data.

Development

Testing

Run the test suite:

npm run test

Linting

Check code style and formatting:

npm run lint

Formatting

Auto-format code:

npm run format

Example Output

Solar System Information

{
  "success": true,
  "results": [{
    "system_id": 30000142,
    "name": "Jita",
    "constellation_id": 20000020,
    "constellation_name": "Kimotoro",
    "region_id": 10000002,
    "region_name": "The Forge",
    "security_status": 0.946,
    "security_class": "B",
    "stargates": [
      "50001248 (Stargate (Perimeter))",
      "50001249 (Stargate (Sobaseki))"
    ],
    "stations": [
      "60003760 (Jita IV - Moon 4 - Caldari Navy Assembly Plant)"
    ],
    "source": {
      "esi": true,
      "sde": true
    }
  }]
}

System Connection Map

{
  "success": true,
  "results": [{
    "system_id": 30000142,
    "system_name": "Jita",
    "security_status": 0.946,
    "connections": [{
      "destination_system_id": 30000144,
      "destination_system_name": "Perimeter",
      "stargate_id": 50001248,
      "stargate_name": "Stargate (Perimeter)",
      "destination_stargate_id": 50000056,
      "destination_stargate_name": "Stargate (Jita)"
    }]
  }]
}

API Reference

This server uses multiple EVE Online APIs:

ESI API Endpoints

POST /universe/ids/ - Convert names to IDs
POST /universe/names/ - Convert IDs to names
GET /universe/systems/ - Get all solar system IDs
GET /universe/systems/{system_id}/ - Get solar system information
GET /universe/stargates/{stargate_id}/ - Get stargate information

SDE API Endpoints

GET /universe/solarSystems - Get all solar system IDs
GET /universe/solarSystems/{solarSystemID} - Get solar system information
GET /universe/stargates - Get all stargate IDs
GET /universe/stargates/{stargateID} - Get stargate information

Features

No Authentication Required: All endpoints use public APIs
Automatic Name Resolution: IDs are automatically resolved to human-readable names
Data Integration: Combines ESI real-time data with SDE static data
Error Resilience: Continues operation even if one API source fails
Batch Processing: Efficient handling of multiple requests
Comprehensive Testing: Full test coverage for all functionality

License

MIT License - see LICENSE file for details.

Contributing

Fork the repository
Create a feature branch
Make your changes
Add tests for new functionality
Run npm run lint and npm run test
Submit a pull request

Acknowledgments

EVE Online ESI API - Official EVE Online API
EVE SDE API - Static Data Export by jita.space
FastMCP - MCP server framework
FastMCP Boilerplate - This project was created using the FastMCP Boilerplate template by Frank Fiegel (frank@glama.ai), licensed under MIT License
tuskermanshu/swagger-mcp-server - Special thanks for the inspiration and foundation for the Swagger/OpenAPI integration in this project.