Eve Est MCP

🚀 EVE Online EST MCP Server

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

🚀 Quick Start

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
npm run dev

✨ 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

The getCurrentESTTime tool provides comprehensive EVE Online server time information:

{
  "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

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