marinetraffic-mcp-server

arifemregursoy/marinetraffic-mcp-server

3.1

If you are the rightful owner of marinetraffic-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

The Marine MCP Server is a Model Context Protocol server that integrates with the Marine Traffic API to provide comprehensive maritime sector data.

Tools
5
Resources
0
Prompts
0

Marine MCP Server

A Model Context Protocol (MCP) server that provides maritime sector data through Marine Traffic API integration.

Overview

This MCP server provides tools and resources for accessing maritime data including:

  • Vessel positions and tracking
  • Port information
  • Ship details and specifications
  • Maritime traffic analysis
  • Route optimization data

Features

  • Vessel Tracking: Real-time vessel positions and movement data
  • Port Information: Comprehensive port details and statistics
  • Ship Database: Access to vessel specifications and details
  • Maritime Analytics: Traffic patterns and route analysis
  • API Integration: Seamless Marine Traffic API integration

Installation

Prerequisites

  • Python 3.8 or higher
  • Marine Traffic API key

Setup

  1. Clone the repository:
git clone https://github.com/yourusername/marine-mcp-server.git
cd marine-mcp-server
  1. Install dependencies:
pip install -e .
  1. Configure your Marine Traffic API key:
cp .env.example .env
# Edit .env and add your MARINE_TRAFFIC_API_KEY

Configuration

Create a .env file in the project root with your Marine Traffic API credentials:

MARINE_TRAFFIC_API_KEY=your_marine_traffic_api_key_here
MARINE_TRAFFIC_BASE_URL=https://services.marinetraffic.com/api
RATE_LIMIT_PER_MINUTE=60
CACHE_EXPIRY_SECONDS=300

Usage

Running the Server

marine-mcp-server

Available Tools

  • get_vessel_positions: Get current positions of vessels in a specific area
  • get_vessel_details: Get detailed information about a specific vessel
  • get_port_info: Get information about ports
  • search_vessels: Search for vessels by various criteria
  • get_voyage_info: Get voyage information for a vessel

Available Resources

  • vessels: List of vessels with basic information
  • ports: Port directory with details
  • routes: Maritime route information

Development

Setup Development Environment

pip install -e ".[dev]"

Running Tests

pytest

Code Formatting

black src/
isort src/
flake8 src/

Type Checking

mypy src/

API Documentation

This server integrates with the Marine Traffic API. You'll need a valid API key from Marine Traffic.

Supported Endpoints

  • Vessel Positions
  • Vessel Details
  • Port Calls
  • Voyage Information
  • Fleet Management

Contributing

  1. Fork the repository
  2. Create a feature branch
  3. Make your changes
  4. Add tests if applicable
  5. Run the test suite
  6. Submit a pull request

Development Setup

git clone https://github.com/arifemregursoy/marine-mcp-server.git
cd marine-mcp-server
pip install -e ".[dev]"

Running Tests

python test_server.py      # Complete test suite
python test_simple_mock.py # Mock data tests
python test_api.py         # Real API tests (requires key)

License

This project is licensed under the MIT License - see the file for details.

What this means:

  • ✅ Free to use for any purpose (personal, commercial, etc.)
  • ✅ Free to modify and distribute
  • ✅ No warranty - use at your own risk
  • ✅ Attribution required - keep the license notice

Disclaimer

This software is provided "as is" without warranty of any kind. The authors are not responsible for any issues, damages, or costs arising from the use of this software.

Support

For issues and questions:

  • 🐛 Open an issue on GitHub
  • 📖 Check the documentation
  • 🌐 Review the Marine Traffic API documentation

Acknowledgments

  • Marine Traffic API for providing maritime data
  • MCP (Model Context Protocol) framework
  • Python open source community

Changelog

v0.1.0

  • Initial release
  • Basic vessel tracking functionality
  • Port information tools
  • Marine Traffic API integration