MarineTraffic MCP Server

by Cyreslab-AI

9 stars

129 downloads

Not rated

GitHub

Description

# MarineTraffic MCP Server [![smithery badge](https://smithery.ai/badge/@Cyreslab-AI/marinetraffic-mcp-server)](https://smithery.ai/server/@Cyreslab-AI/marinetraffic-mcp-server) A Model Context Protocol (MCP) server that provides access to MarineTraffic vessel tracking data. ##…

About

Details

Author: Cyreslab-AI
GitHub stars: 9
Downloads: 129
Categories: Search, Other, API

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name MarineTraffic MCP Server

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "marinetraffic mcp server": {
            "marinetraffic-mcp-server": {
                "command": "npx",
                "args": [
                    "-y",
                    "@smithery/cli",
                    "install",
                    "@Cyreslab-AI/marinetraffic-mcp-server",
                    "--client",
                    "claude"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "marinetraffic mcp server": {
            "marinetraffic-mcp-server": {
                "command": "npx",
                "args": [
                    "-y",
                    "@smithery/cli",
                    "install",
                    "@Cyreslab-AI/marinetraffic-mcp-server",
                    "--client",
                    "claude"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "marinetraffic mcp server": {
            "marinetraffic-mcp-server": {
                "command": "npx",
                "args": [
                    "-y",
                    "@smithery/cli",
                    "install",
                    "@Cyreslab-AI/marinetraffic-mcp-server",
                    "--client",
                    "claude"
                ]
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "marinetraffic mcp server": {
            "marinetraffic-mcp-server": {
                "command": "npx",
                "args": [
                    "-y",
                    "@smithery/cli",
                    "install",
                    "@Cyreslab-AI/marinetraffic-mcp-server",
                    "--client",
                    "claude"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "marinetraffic mcp server": {
            "marinetraffic-mcp-server": {
                "command": "npx",
                "args": [
                    "-y",
                    "@smithery/cli",
                    "install",
                    "@Cyreslab-AI/marinetraffic-mcp-server",
                    "--client",
                    "claude"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "marinetraffic mcp server": {
            "marinetraffic-mcp-server": {
                "command": "npx",
                "args": [
                    "-y",
                    "@smithery/cli",
                    "install",
                    "@Cyreslab-AI/marinetraffic-mcp-server",
                    "--client",
                    "claude"
                ]
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "marinetraffic mcp server": {
            "marinetraffic-mcp-server": {
                "command": "npx",
                "args": [
                    "-y",
                    "@smithery/cli",
                    "install",
                    "@Cyreslab-AI/marinetraffic-mcp-server",
                    "--client",
                    "claude"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "marinetraffic mcp server": {
            "marinetraffic-mcp-server": {
                "command": "npx",
                "args": [
                    "-y",
                    "@smithery/cli",
                    "install",
                    "@Cyreslab-AI/marinetraffic-mcp-server",
                    "--client",
                    "claude"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "marinetraffic mcp server": {
            "marinetraffic-mcp-server": {
                "command": "npx",
                "args": [
                    "-y",
                    "@smithery/cli",
                    "install",
                    "@Cyreslab-AI/marinetraffic-mcp-server",
                    "--client",
                    "claude"
                ]
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "marinetraffic mcp server": {
            "marinetraffic-mcp-server": {
                "command": "npx",
                "args": [
                    "-y",
                    "@smithery/cli",
                    "install",
                    "@Cyreslab-AI/marinetraffic-mcp-server",
                    "--client",
                    "claude"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "marinetraffic mcp server": {
            "marinetraffic-mcp-server": {
                "command": "npx",
                "args": [
                    "-y",
                    "@smithery/cli",
                    "install",
                    "@Cyreslab-AI/marinetraffic-mcp-server",
                    "--client",
                    "claude"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "marinetraffic mcp server": {
            "marinetraffic-mcp-server": {
                "command": "npx",
                "args": [
                    "-y",
                    "@smithery/cli",
                    "install",
                    "@Cyreslab-AI/marinetraffic-mcp-server",
                    "--client",
                    "claude"
                ]
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "marinetraffic mcp server": {
            "marinetraffic-mcp-server": {
                "command": "npx",
                "args": [
                    "-y",
                    "@smithery/cli",
                    "install",
                    "@Cyreslab-AI/marinetraffic-mcp-server",
                    "--client",
                    "claude"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "marinetraffic mcp server": {
            "marinetraffic-mcp-server": {
                "command": "npx",
                "args": [
                    "-y",
                    "@smithery/cli",
                    "install",
                    "@Cyreslab-AI/marinetraffic-mcp-server",
                    "--client",
                    "claude"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "marinetraffic mcp server": {
            "marinetraffic-mcp-server": {
                "command": "npx",
                "args": [
                    "-y",
                    "@smithery/cli",
                    "install",
                    "@Cyreslab-AI/marinetraffic-mcp-server",
                    "--client",
                    "claude"
                ]
            }
        }
    }
}

From the repository

Install via Smithery (npx -y @smithery/cli install @Cyreslab-AI/marinetraffic-mcp-server --client claude) or manually by cloning the repository, installing dependencies, and building. Configure by setting the MARINETRAFFIC_API_KEY environment variable and adding the server to MCP settings (e.g., claude_desktop_config.json). Use the provided tools and resources through MCP-enabled clients.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "marinetraffic mcp server": {
            "marinetraffic-mcp-server": {
                "command": "npx",
                "args": [
                    "-y",
                    "@smithery/cli",
                    "install",
                    "@Cyreslab-AI/marinetraffic-mcp-server",
                    "--client",
                    "claude"
                ]
            }
        }
    }
}

McpServers

{
    "marinetraffic-mcp-server": {
        "command": "npx",
        "args": [
            "-y",
            "@smithery/cli",
            "install",
            "@Cyreslab-AI/marinetraffic-mcp-server",
            "--client",
            "claude"
        ]
    }
}

MarineTraffic MCP Server

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

Features

This MCP server provides the following capabilities:

Tools

- get_vessel_position: Get real-time position of a vessel by MMSI or IMO number
- get_vessel_details: Get detailed information about a vessel by MMSI or IMO number
- search_vessels: Search for vessels by name, MMSI, IMO, or vessel type
- get_vessels_in_area: Get vessels in a specified geographic area

Resources

- vessel://{identifier}: Information about a vessel by MMSI or IMO number
- vessels://area/{lat}/{lon}/{radius}: List of vessels in a specified geographic area

Installation

Installing via Smithery

To install MarineTraffic Vessel Tracking Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @Cyreslab-AI/marinetraffic-mcp-server --client claude

Prerequisites

- Node.js 18 or higher
- A MarineTraffic API key (available from MarineTraffic 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

Configuration

The server requires a MarineTraffic API key to function. You can provide this through 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 it with Claude to access vessel tracking data:

Get Vessel Position

<use_mcp_tool>
<server_name>marinetraffic</server_name>
<tool_name>get_vessel_position</tool_name>
<arguments>
{
  "identifier": "123456789"
}
</arguments>
</use_mcp_tool>

Search for Vessels

<use_mcp_tool>
<server_name>marinetraffic</server_name>
<tool_name>search_vessels</tool_name>
<arguments>
{
  "vessel_name": "MAERSK"
}
</arguments>
</use_mcp_tool>

Get Vessels in Area

<use_mcp_tool>
<server_name>marinetraffic</server_name>
<tool_name>get_vessels_in_area</tool_name>
<arguments>
{
  "latitude": 37.8199,
  "longitude": -122.4783,
  "radius": 10
}
</arguments>
</use_mcp_tool>

Access Vessel Resource

<access_mcp_resource>
<server_name>marinetraffic</server_name>
<uri>vessel://123456789</uri>
</access_mcp_resource>

API Key Limitations

The MarineTraffic API has usage limits based on your subscription plan. Be aware of these limits when using the server to avoid exceeding your quota.

Troubleshooting

- API Key Errors: Ensure your MarineTraffic API key is valid and correctly set in the environment variables.
- Rate Limiting: If you encounter rate limiting errors, the server will automatically retry with exponential backoff, but you may need to wait before making additional requests.
_Example of detailed vessel information available through the API_

API Key Limitations

The MarineTraffic API has usage limits based on your subscription plan. Be aware of these limits when using the server to avoid exceeding your quota.

Troubleshooting

- API Key Errors: Ensure your MarineTraffic API key is valid and correctly set in the environment variables.
- Rate Limiting: If you encounter rate limiting errors, the server will automatically retry with exponential backoff, but you may need to wait before making additional requests.
- No Data Found: Some vessels may not have real-time tracking data available, especially smaller vessels or those in areas with limited AIS coverage.

License

This project is licensed under the ISC License.

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

Description

About

Details

Jump to

Setting up with Highlight

From the repository

Claude Desktop / Cursor

McpServers

MarineTraffic MCP Server

Features

Tools

Resources

Installation

Installing via Smithery

Prerequisites

Setup

Configuration

MCP Settings Configuration

For Claude Desktop App (macOS)

For Claude VSCode Extension

Usage Examples

Get Vessel Position

Search for Vessels

Get Vessels in Area

Access Vessel Resource

API Key Limitations

Troubleshooting

API Key Limitations

Troubleshooting

License

Install

More like this

Sequential Thinking

Brave Search

Filesystem

EverArt

Google Drive

GitLab