Eve Online Traffic MCP

🚀 EVE Online Traffic MCP Server

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

⚠️ Important Note

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.

🚀 Quick Start

This MCP server offers a wide - range of tools for accessing EVE Online data. It combines the official ESI API and SDE data to provide comprehensive information about the game universe.

✨ 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

📦 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

💡 Usage Tip

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 Examples

Development Mode

npm run dev

Production Mode

npm run start

Build

npm run build

Usage Notes

⚠️ Important Note

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.

📚 Documentation

Testing

npm run test

Linting

npm run lint

Formatting

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)"
    }]
  }]
}

🔧 Technical Details

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

Other 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

This project is under the MIT License. See LICENSE file for details.

Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests for new functionality
5. Run npm run lint and npm run test
6. 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.