# mcp-maritime 🚢

> Maritime and weather data MCP Server for Claude Code and AI agents.

[![PyPI](https://img.shields.io/pypi/v/mcp-maritime)](https://pypi.org/project/mcp-maritime/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

Give your AI agent access to real marine weather, wave forecasts, tropical cyclone warnings, and route calculations — powered by free public APIs.

## Installation

```bash
pip install mcp-maritime
# or
uv add mcp-maritime
```

## Usage with Claude Code

Add to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "maritime": {
      "command": "mcp-maritime"
    }
  }
}
```

Or run directly:

```bash
mcp-maritime
```

## Available Tools

| Tool | Description | Data Source |
|------|-------------|-------------|
| `get_marine_weather` | Wave height, wind, sea temp forecast | Open-Meteo Marine (free) |
| `get_weather_forecast` | General weather forecast | Open-Meteo (free) |
| `calculate_route_distance` | Great Circle distance in nautical miles | Local calculation |
| `get_tropical_cyclone_forecast` | Typhoon / hurricane warnings | JTWC / NHC (free) |

## Example

```
User: What are the current wave conditions at 35°N, 140°E?

Claude: [uses get_marine_weather tool]
Wave height: 2.5m, Wind: 15 knots NNE, Sea temp: 22°C
Forecast for next 3 days: increasing to 4m by tomorrow afternoon...
```

## Roadmap

- [ ] AIS ship tracking integration
- [ ] Port tide tables
- [ ] Weather routing optimization
- [ ] High-precision WNI data (premium tier)

## Sponsorship

If this tool is useful to you, consider [sponsoring on GitHub](https://github.com/sponsors/suz-ry) ☕

## License

MIT