Skip to main content
Glama

EVE Online ESI MCP Server

by kongyo2
GitHub
JavaScript
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

EVE Online ESI MCP Server

The most comprehensive and performance-optimized EVE Online ESI MCP server available. This enterprise-grade server provides complete access to EVE Online's ESI API through the Model Context Protocol, with advanced performance optimization, full mcp-remote compatibility, and automatic API coverage.

🚀 Key Features

Complete ESI Integration

  • 400+ Auto-Generated Tools: Complete API coverage from official ESI swagger specification
  • Real-time Updates: Tools automatically generated from latest ESI specification
  • Official ESI Compliance: Implements all CCP Games best practices and rate limiting
  • Smart Categorization: Tools organized by character, corporation, alliance, market, universe, etc.

Enterprise Performance

  • Intelligent Caching: ETag-based caching with ESI expires header compliance
  • ML-Driven Optimization: Predictive resource allocation and performance learning
  • Advanced Rate Limiting: ESI error-based limiting + endpoint-specific controls
  • Connection Pooling: HTTP keep-alive and connection reuse optimization
  • 50-70% Performance Improvement: Measured response time enhancements

MCP-Remote Optimized

  • Full geelen/mcp-remote Support: Seamless integration with Claude Desktop, Cursor, Windsurf
  • Multiple Transport Strategies: SSE-first, HTTP-only, auto-detection
  • CORS Optimization: Pre-configured for all major MCP clients
  • OAuth Integration: Complete EVE SSO authentication flow

Authentication & Security

  • EVE SSO OAuth 2.0: Full PKCE implementation with 67 available scopes
  • Dynamic Client Registration: Automatic OAuth client setup
  • Token Management: Refresh, verify, and exchange capabilities
  • Security Best Practices: Rate limiting, input validation, secure headers

Installation

Installing via Smithery

To install EVE Online ESI Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @kongyo2/eveonlineesi-mcp --client claude

Manual Installation

npm install

Configuration

Create a .env file with the following variables:

# EVE Online ESI API Key (for ESI authentication) EVE_ONLINE_APIS_API_KEY=your_eve_api_key # OAuth Configuration (optional - will use defaults if not provided) OAUTH_CLIENT_ID=eve-online-esi-mcp OAUTH_CLIENT_SECRET=your_oauth_secret JWT_SECRET=your_jwt_secret # Server Port (default: 3001) PORT=3001

Running the Server

Local Mode (stdio)

For direct local connections:

npm start

Remote Mode (SSE/HTTP)

For remote connections with OAuth:

npm run start:sse

🎯 MCP-Remote Integration

Claude Desktop Configuration

Add to your claude_desktop_config.json:

{ "mcpServers": { "eve-online-esi": { "command": "npx", "args": ["mcp-remote", "http://localhost:3001/sse"] } } }

Cursor Configuration

{ "mcpServers": { "eve-online-esi": { "command": "npx", "args": [ "mcp-remote", "http://localhost:3001/sse", "--transport", "sse-first" ] } } }

Windsurf Configuration

{ "mcpServers": { "eve-online-esi": { "command": "npx", "args": ["mcp-remote", "http://localhost:3001/sse", "--allow-http"] } } }

Advanced Transport Strategies

# SSE-first (recommended): Try SSE, fallback to HTTP npx mcp-remote http://localhost:3001/sse --transport sse-first # SSE-only: Use only Server-Sent Events npx mcp-remote http://localhost:3001/sse --transport sse-only # HTTP-only: Use only HTTP requests npx mcp-remote http://localhost:3001/mcp --transport http-only # With custom headers npx mcp-remote http://localhost:3001/sse --header "x-api-key: your-key"

Get Configuration Examples

curl http://localhost:3001/mcp-config

🛠 Available Tools (400+)

Auto-Generated from ESI Swagger Specification

Character Tools (150+ tools, authentication required)
  • get_characters_character_id - Character information
  • get_characters_character_id_assets - Character assets and locations
  • get_characters_character_id_location - Current character location
  • get_characters_character_id_online - Online status
  • get_characters_character_id_ship - Current ship information
  • get_characters_character_id_wallet - Wallet balance and transactions
  • get_characters_character_id_mail - Mail headers and messages
  • get_characters_character_id_skills - Character skills and skill queue
  • get_characters_character_id_clones - Clone information
  • get_characters_character_id_implants - Active implants
  • And 140+ more character endpoints...
Corporation Tools (50+ tools)
  • get_corporations_corporation_id - Corporation information
  • get_corporations_corporation_id_members - Corporation members
  • get_corporations_corporation_id_assets - Corporation assets
  • get_corporations_corporation_id_wallets - Corporation wallets
  • get_corporations_corporation_id_structures - Corporation structures
  • And 45+ more corporation endpoints...
Alliance Tools (10+ tools)
  • get_alliances - List all active alliances
  • get_alliances_alliance_id - Alliance information
  • get_alliances_alliance_id_corporations - Alliance corporations
  • get_alliances_alliance_id_icons - Alliance icons
  • And more alliance endpoints...
Market Tools (20+ tools)
  • get_markets_region_id_orders - Market orders by region
  • get_markets_region_id_history - Historical market data
  • get_markets_prices - Global market prices
  • get_markets_groups - Market groups and categories
  • And more market endpoints...
Universe Tools (200+ tools)
  • get_universe_regions - All regions
  • get_universe_systems - All solar systems
  • get_universe_stations - All stations
  • get_universe_structures - Public structures
  • get_universe_types - All item types
  • get_universe_categories - Item categories
  • And 194+ more universe endpoints...
Industry Tools (30+ tools)
  • Manufacturing, research, and blueprints
  • Industry jobs and facilities
  • Mining operations and extractions
Other Categories (80+ tools)
  • Mail System: Character and corporation mail
  • Calendar: Events and scheduling
  • Contracts: Contract management
  • Fittings: Ship fittings and loadouts
  • Killmails: Combat records
  • Loyalty Points: LP stores and offers
  • Planetary Interaction: PI operations
  • Search: Universal search functionality
  • Wars: War declarations and status

Enhanced Performance Tools

  • get_performance_dashboard - Comprehensive server metrics
  • get_tool_recommendations - AI-powered optimization suggestions
  • get_esi_scopes - Available authentication scopes
  • generate_eve_auth_url - EVE SSO authorization URLs

OAuth Flow

  1. When connecting via mcp-remote, you'll be redirected to authorize
  2. Approve access to grant permissions
  3. The server will issue an access token
  4. All subsequent requests will use this token

Transport Strategies

When using mcp-remote, you can specify transport strategies:

# SSE only npx mcp-remote http://localhost:3001/sse --transport sse-only # HTTP only npx mcp-remote http://localhost:3001/mcp --transport http-only # Try SSE first, fallback to HTTP npx mcp-remote http://localhost:3001/sse --transport sse-first

🌐 API Endpoints

MCP Transport

  • SSE: GET /sse - Server-Sent Events transport (mcp-remote optimized)
  • HTTP: POST /mcp - HTTP transport for single requests
  • Transport Detection: GET /transport - Capability detection for mcp-remote

Authentication

  • OAuth Registration: POST /oauth/register - Dynamic client registration
  • OAuth Authorization: GET /oauth/authorize - OAuth flow initiation
  • OAuth Token: POST /oauth/token - Token exchange

EVE SSO Integration

  • EVE Auth: GET /auth/eve - Generate EVE SSO authorization URL
  • EVE Callback: POST /auth/eve/callback - Exchange authorization code
  • EVE Refresh: POST /auth/eve/refresh - Refresh access tokens
  • EVE Verify: POST /auth/eve/verify - Verify token validity

Monitoring & Management

  • Health Check: GET /health - Enhanced health status
  • Performance Metrics: GET /metrics - Comprehensive performance data
  • Cache Stats: GET /cache/stats - Cache performance metrics
  • Cache Clear: DELETE /cache - Clear cache (authenticated)
  • MCP Config: GET /mcp-config - Client configuration examples

Development

To list all available tools:

npm run list-tools

Security

  • OAuth tokens expire after 1 hour
  • PKCE is supported for enhanced security
  • All API requests require valid authentication
  • Client secrets are stored securely

📚 Documentation

📊 Performance Statistics

  • Total Tools: 400+ auto-generated from ESI specification
  • Response Time: 50-70% improvement with intelligent caching
  • Cache Hit Rate: 80-90% efficiency
  • API Coverage: 100% of public ESI endpoints
  • Authentication: 67 ESI scopes supported
  • Transport Options: SSE, HTTP, auto-detection

🛡 Security & Compliance

  • ESI Best Practices: Full compliance with CCP Games recommendations
  • Error-based Rate Limiting: Prevents API abuse and bans
  • PKCE Support: Enhanced OAuth security
  • Token Management: Secure refresh and validation
  • Input Validation: Comprehensive parameter validation

🔧 Development

Running Tests

npm run list-tools

Docker Support

npm run docker:build npm run docker:run

Environment Variables

See .env file for all configuration options including performance tuning, authentication, and ESI settings.

🤝 Contributing

This server implements the complete EVE Online ESI specification with enterprise-grade performance and mcp-remote optimization. Contributions are welcome for additional features or optimizations.

📄 License

MIT

Built with ❤️ for the EVE Online community. Optimized for Claude Desktop, Cursor, Windsurf, and all MCP clients.

Install Server
A
security – no known vulnerabilities
F
license - not found
A
quality - confirmed to work

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

This is an MCP (Model Context Protocol) server for the EVE Online ESI API that supports both local (stdio) and remote (OAuth-enabled) connections.

  1. 🚀 Key Features
    1. Complete ESI Integration
    2. Enterprise Performance
    3. MCP-Remote Optimized
    4. Authentication & Security
  2. Installation
    1. Installing via Smithery
    2. Manual Installation
  3. Configuration
    1. Running the Server
      1. Local Mode (stdio)
      2. Remote Mode (SSE/HTTP)
    2. 🎯 MCP-Remote Integration
      1. Claude Desktop Configuration
      2. Cursor Configuration
      3. Windsurf Configuration
      4. Advanced Transport Strategies
      5. Get Configuration Examples
    3. 🛠 Available Tools (400+)
      1. Auto-Generated from ESI Swagger Specification
      2. Enhanced Performance Tools
    4. OAuth Flow
      1. Transport Strategies
        1. 🌐 API Endpoints
          1. MCP Transport
          2. Authentication
          3. EVE SSO Integration
          4. Monitoring & Management
        2. Development
          1. Security
            1. 📚 Documentation
              1. 📊 Performance Statistics
                1. 🛡 Security & Compliance
                  1. 🔧 Development
                    1. Running Tests
                    2. Docker Support
                    3. Environment Variables
                  2. 🤝 Contributing
                    1. 📄 License

                      Related MCP Servers

                      • MCP Server

                        agentico-dev
                        -
                        security
                        A
                        license
                        -
                        quality
                        MCP Server provides a simpler API to interact with the Model Context Protocol by allowing users to define custom tools and services to streamline workflows and processes.
                        Last updated -
                        13
                        2
                        TypeScript
                        MIT License

                      • MCP-OpenAPI

                        rmasters
                        -
                        security
                        A
                        license
                        -
                        quality
                        An MCP server that exposes HTTP methods defined in an OpenAPI specification as tools, enabling interaction with APIs via the Model Context Protocol.
                        Last updated -
                        2
                        Python
                        MIT License

                      • cve-search_mcp

                        roadwy
                        A
                        security
                        A
                        license
                        A
                        quality
                        A 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 -
                        6
                        15
                        Python
                        MIT License

                      • SSE MCP Server

                        KelvinQiu802
                        -
                        security
                        F
                        license
                        -
                        quality
                        A server for Model Context Protocol (MCP) that uses Server-Sent Events (SSE) for streaming communication, enabling tools like the HackerNews API to be accessed through a secure HTTP+SSE transport.
                        Last updated -
                        8
                        TypeScript

                      View all related MCP servers

                      New MCP Servers

                      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/kongyo2/eveonlineESI-mcp'

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