mcpField
J
Japan Port Vessel Traffic MCP (AIS Position & ETA)

Japan Port Vessel Traffic MCP (AIS Position & ETA)

Local
github.com/atushi1841Maps & Travel0Updated 3d ago
Repository

About Japan Port Vessel Traffic MCP (AIS Position & ETA)

Japan Port Vessel Traffic MCP provides AIS-based vessel traffic data for major Japanese ports. It is intended for users tracking ships and port activity, with live positions, historical tracks, and ETA estimates.

Key features

  1. 01List 20 configured Japanese ports
  2. 02Retrieve live vessel positions and details
  3. 03Get historical tracks as GeoJSON
  4. 04Estimate ETA and delays
  5. 05Summarize port activity

Use cases

  1. 01Check vessels currently in a port
  2. 02Review a vessel's historical route
  3. 03Estimate arrival times and delays
  4. 04Monitor aggregated port activity

MCP support

The MCP server exposes tools for Japanese port catalogs, live vessel data, historical tracks, ETA estimates, and port activity summaries.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

No install method listed yet

We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.

Repository
Packages
mcpbserver.mcpb0.1.0

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

Japan Port Vessel Traffic MCP

OpenWaters AIS ベースの日本港湾船舶交通データ MCP サーバー。 API キー不要・完全無料・公開 AIS データ（tosa compliant）。

Features

  • 20 major Japanese ports pre-configured with bounding boxes
  • Real-time vessel position, name, IMO, flag, destination, ETA
  • Historical track (up to 366 days)
  • ETA & delay estimation (AIS-reported vs speed-projected)
  • Port overview aggregation (counts by type, flag, status)

Data source

Open Waters AIS — aggregate of community AIS receivers, AISHub, aisstream. No official API key required for the anonymous tier. Source: https://ais.openwaters.io/api/ais/

Installation

git clone https://github.com/atushi1841/japan-port-vessel-mcp.git
cd japan-port-vessel-mcp
uv sync  # or: pip install -r requirements.txt

Usage (stdio)

uv run --directory . src/stdio_main.py

Or configure in Claude Desktop / Cursor MCP settings:

{
  "mcpServers": {
    "japan-port-vessel": {
      "command": "uv",
      "args": ["run", "--directory", "<path-to-repo>", "src/stdio_main.py"]
    }
  }
}

Tools

ToolDescription
list_japan_ports()Catalog of 20 Japanese ports with bboxes
get_vessels_in_port(port_code, limit=30)Live vessel list within a port bbox
get_vessel(mmsi)Single-vessel latest position + static info
get_vessel_track(mmsi, hours=24, interval="5m", limit=500)Historical track as GeoJSON coordinates
estimate_vessel_eta(mmsi, port_code=None)ETA delay estimation
get_port_overview(port_code, max_age_hours=6)Aggregated port activity summary

Quick examples

# List Japanese ports
ports = list_japan_ports()

# Vessels in Tokyo Bay
tokyo = get_vessels_in_port("JPTYO", limit=20)

# ETA delay for a specific vessel
eta = estimate_vessel_eta("431005321", port_code="JPTYO")
print(eta["delay_hours"])

License

MIT — like the Open Waters AIS network. Attribution required.

Related

Apify Store

This MCP server is published as an Apify Actor: japan-port-vessel-mcp.

Apify Store: atushi1841

Data & Store

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.