Allows installation and contribution to the EVE Online Traffic MCP through GitHub repositories, with instructions for forking, creating feature branches, and submitting pull requests.
Integrates with EVE Online's Swagger/OpenAPI interfaces, utilizing both official ESI API and third-party SDE APIs to provide comprehensive EVE Online universe data.
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:
Manual Installation
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:
Production Mode
Start the server for production use:
Build
Compile TypeScript to JavaScript:
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:
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:
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:
Route Calculation Tools
calculate_route
Calculate the shortest route between two EVE Online solar systems.
Parameters:
origin
: Origin solar system name or IDdestination
: Destination solar system name or IDflag
: (Optional)shortest
(default),secure
, orinsecure
avoidSystems
: (Optional) Array of system names or IDs to avoid
Example:
calculate_multiple_routes
Calculate routes from one origin to multiple destinations.
Parameters:
origin
: Origin solar system name or IDdestinations
: Array of destination system names or IDs (max 20)flag
: (Optional)shortest
(default),secure
, orinsecure
avoidSystems
: (Optional) Array of system names or IDs to avoid
Example:
find_systems_in_range
Find all solar systems within a specified jump range from an origin system.
Parameters:
origin
: Origin solar system name or IDmaxJumps
: Maximum number of jumps (1-10)flag
: (Optional)shortest
(default),secure
, orinsecure
avoidSystems
: (Optional) Array of system names or IDs to avoid
Example:
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:
Linting
Check code style and formatting:
Formatting
Auto-format code:
Example Output
Solar System Information
System Connection Map
API Reference
This server uses multiple EVE Online APIs:
ESI API Endpoints
POST /universe/ids/
- Convert names to IDsPOST /universe/names/
- Convert IDs to namesGET /universe/systems/
- Get all solar system IDsGET /universe/systems/{system_id}/
- Get solar system informationGET /universe/stargates/{stargate_id}/
- Get stargate information
SDE API Endpoints
GET /universe/solarSystems
- Get all solar system IDsGET /universe/solarSystems/{solarSystemID}
- Get solar system informationGET /universe/stargates
- Get all stargate IDsGET /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
andnpm 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.
Tools
A comprehensive Model Context Protocol (MCP) server for EVE Online traffic, navigation, and system information using both the official ESI API and SDE data.
Related MCP Servers
- AsecurityAlicenseAqualityA Model Context Protocol (MCP) server for querying the CVE-Search API. This server provides comprehensive access to CVE-Search, browse vendor and product、get CVE per CVE-ID、get the last updated CVEs.Last updated -638PythonMIT License
- AsecurityFlicenseAqualityThis is an MCP (Model Context Protocol) server for the EVE Online ESI API that supports both local (stdio) and remote (OAuth-enabled) connections.Last updated -39JavaScript
- AsecurityAlicenseAqualityこのMCPサーバーは、EVE Onlineのマーケットデータにアクセスするためのインターフェースを提供します。ESI(EVE Swagger Interface)APIを使用して、リアルタイムの市場データを取得できます。Last updated -103TypeScriptMIT License
- -securityAlicense-qualityA Model Context Protocol (MCP) server that supports STDIO, SSE and Streamable HTTP protocols for AI model interactions.Last updated -4TypeScriptMIT License