EVE EST MCP

🚀 EVE Online EST MCP Server

An MCP server for EVE Online that offers EVE Server Time (EST) information and downtime calculations.

EVE Server Time (EST) is the same as UTC and serves as the standard time across all EVE Online servers. This server provides the current EST time and calculates the remaining time until the next daily server downtime.

✨ Features

• Current EVE Server Time: Retrieve the current time in EVE Server Time format (identical to UTC).
• Downtime Information: Daily server maintenance takes place from 11:00 to 11:15 EST (UTC).
• Time Until Downtime: Calculate the hours and minutes until the next server downtime.
• Downtime Status: Indicate whether the server is currently in downtime.
• Reliable Time Source: Utilize the system time, with WorldTimeAPI (worldtimeapi.org) as a fallback for maximum reliability.

💻 Usage Examples

Basic Usage

{
  "currentTime": "2025-01-08 15:30:45 EST",
  "utcTime": "2025-01-08T15:30:45.123Z",
  "isInDowntime": false,
  "downtimeWindow": "11:00 to 11:15 EST (UTC)",
  "timeUntilNextDowntime": "19h 29m",
  "nextDowntimeStart": "2025-01-09 11:00:00 EST",
  "timeSource": "system"
}

The timeSource field indicates whether the time was obtained from the system clock ("system") or from the WorldTimeAPI fallback ("worldtimeapi").

📦 Installation

To get started, clone the repository and install the dependencies.

git clone https://github.com/kongyo2/EVE-EST-MCP.git
cd eve-online-est-mcp-server
npm install

Start the server

If you simply want to start the server, you can use the start script.

npm run start

However, you can also interact with the server using the dev script.

npm run dev

This will start the server and allow you to interact with it using CLI.

Testing

The server includes tests for time calculations and EST formatting.

npm run test

The tests verify the EVE Server Time calculations and downtime logic.

Linting

Having a good linting setup reduces the friction for other developers to contribute to your project.

npm run lint

This project uses Prettier, ESLint and TypeScript ESLint to lint the code.

Formatting

Use npm run format to format the code.

npm run format