Marinetraffic MCP Server

🚀 Maritime Traffic MCP Server

A Model Context Protocol (MCP) server that provides access to maritime traffic vessel tracking data.

🚀 Quick Start

This MCP server offers access to maritime traffic vessel tracking data. It comes with a set of tools and resources to interact with vessel information.

✨ Features

This MCP server provides the following features:

Tools

• get_vessel_position: Retrieve the real - time position of a vessel by its MMSI or IMO number.
• get_vessel_details: Obtain detailed information about a vessel using its MMSI or IMO number.
• search_vessels: Search for vessels by name, MMSI, IMO, or vessel type.
• get_vessels_in_area: Get vessels within a specified geographical area.

Resources

• vessel://{identifier}: Fetch vessel information by MMSI or IMO number.
• vessels://area/{lat}/{lon}/{radius}: List vessels within a specified geographical area.

📦 Installation

Prerequisites

• Node.js 18 or higher.
• A Maritime Traffic API key (available from Maritime Traffic API Services).

Setup

1. Clone this repository or download the source code.
2. Install dependencies:

cd marinetraffic-server
npm install

3. Build the server:

npm run build

📚 Documentation

Configuration

The server requires a Maritime Traffic API key to run. You can provide this key via the environment variable MARINETRAFFIC_API_KEY.

MCP Settings Configuration

To use this server with Claude, add it to your MCP settings configuration file:

For Claude Desktop App (macOS)

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "marinetraffic": {
      "command": "node",
      "args": ["/path/to/marinetraffic-server/build/index.js"],
      "env": {
        "MARINETRAFFIC_API_KEY": "your-api-key-here"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

For Claude VSCode Extension

Edit ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json:

{
  "mcpServers": {
    "marinetraffic": {
      "command": "node",
      "args": ["/path/to/marinetraffic-server/build/index.js"],
      "env": {
        "MARINETRAFFIC_API_KEY": "your-api-key-here"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

💻 Usage Examples

Once the server is configured and running, you can use Claude to perform the following operations:

• Get real - time vessel position: get_vessel_position
• Get vessel details: get_vessel_details
• Search for vessels: search_vessels
• Get vessels in an area: get_vessels_in_area

📄 License

This project is released under the ISC license.