EVE Fleet

Provides fleet management data and actions through MCP, including SSO authorization, composition, formations, invites, and MOTD updates.

python

1

GitHub Stars

python

Language

4 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "tedfytw1209-mcp-server-evefleet": {
      "command": "uv",
      "args": [
        "run",
        "mcp",
        "dev",
        "./src/mcp_server_evefleet/server.py"
      ]
    }
  }
}

You can deploy and run the EVE Fleet MCP Server to manage fleet operations in EVE Online through an MCP client. This server provides tools for SSO authorization, fleet inspection, squad organization, bulk invites/kicks, and MOTD updates, along with historical data on fleet composition and losses. It’s designed to simplify fleet management by offering programmatic access to common fleet administration tasks.

How to use

You interact with the EVE Fleet MCP Server by starting the MCP runner and connecting with an MCP client. Use the provided tools to authenticate your fleet via SSO, refresh and inspect fleet data, organize formations, invite or remove members in bulk, and update the fleet MOTD. You can also query historical composition and losses data and translate ship types to groups for quick references.

How to install

Prerequisites: Python and a Python package manager. Ensure Python 3.8+ is installed on your system.

Install the MCP server package from PyPI.

pip install mcp-server-evefleet

Additional notes

Authenticate on the first run to authorize your fleet with EVE SSO. A refresh token is saved to a cross‑platform location for subsequent runs.

On Windows, the refresh token is stored at %LOCALAPPDATA%/mcp_server_evefleet/refresh_token.txt. On macOS, it is stored at ~/Library/Application Support/mcp_server_evefleet/refresh_token.txt. On Linux, it is stored at ~/.config/mcp_server_evefleet/refresh_token.txt. If a refresh_token.txt exists in the current directory, it will be used and then persisted to the proper location.

Development and runtime data can be handled via the MCP test command shown below to run the server in development mode.

Available tools

ping

Health check to verify the MCP server is responsive.

fleet_authorize

Authorize or refresh the fleet's SSO session and establish a connection.

organize_fleet_formation

Organize fleet members into formations or squads, with options for sizing and location matching.

invite_to_fleet

Invite one or more members to the fleet by id or name.

kick_from_fleet

Remove one or more members from the fleet by id or name, with optional delay between actions.

update_fleet_motd

Update the fleet MOTD, with options to append or replace existing text.

get_fleet_history

Retrieve historical data about fleet composition and changes.

get_fleet_losses

Retrieve historical loss data for the fleet.

ship_type2group

Map a ship type to its corresponding group for quick reference.