JMA Data MCP

Japan Meteorological Agency (JMA) data MCP server.

Features

• AMeDAS (Automated Meteorological Data Acquisition System) station data
• 1286 observation stations across Japan
• Search by station code, name, or location
• Real-time weather observation data (temperature, humidity, wind, precipitation, etc.)
• Historical weather data (past 1-2 weeks)
• Time series data for trend analysis
• Weather forecast by prefecture

Data Source

• AMeDAS station data: https://www.jma.go.jp/bosai/amedas/
• Real-time observation: https://www.jma.go.jp/bosai/amedas/
• Weather forecast: https://www.jma.go.jp/bosai/forecast/

Installation

uv tool install git+https://github.com/koizumikento/jma-data-mcp.git

Or install locally:

git clone https://github.com/koizumikento/jma-data-mcp.git
cd jma-data-mcp
uv sync

MCP Server Configuration

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

Installed version:

{
  "mcpServers": {
    "jma-data-mcp": {
      "command": "jma-data-mcp"
    }
  }
}

Direct from GitHub:

{
  "mcpServers": {
    "jma-data-mcp": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/koizumikento/jma-data-mcp.git",
        "jma-data-mcp"
      ]
    }
  }
}

Local development:

{
  "mcpServers": {
    "jma-data-mcp": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/path/to/jma-data-mcp",
        "jma-data-mcp"
      ]
    }
  }
}

Cursor

Add to .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "jma-data-mcp": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/koizumikento/jma-data-mcp.git",
        "jma-data-mcp"
      ]
    }
  }
}

Cline

Add to Cline MCP settings:

{
  "mcpServers": {
    "jma-data-mcp": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/koizumikento/jma-data-mcp.git",
        "jma-data-mcp"
      ]
    }
  }
}

Available Tools

Station Tools

• get_station_info - Get station by code
• search_stations - Search stations by name
• search_nearby_stations - Search stations within radius
• get_stations_of_type - Get stations by type (A-F)
• list_stations - List all stations with pagination

Weather Tools

• get_current_weather - Get current weather observation from AMeDAS
• get_weather_by_location - Get weather from nearest station to coordinates
• get_forecast - Get weather forecast for a prefecture
• list_prefectures - List available prefecture codes

Historical Data Tools

• get_historical_weather - Get weather data for a specific past date/time (available for ~1-2 weeks)
• get_weather_time_series - Get time series data for trend analysis (hourly data up to 1 week)

Weather Data

The get_current_weather tool returns:

Field	Description	Unit
temperature	Air temperature	℃
humidity	Relative humidity	%
pressure	Station pressure	hPa
sea_level_pressure	Sea level pressure	hPa
wind.speed	Wind speed	m/s
wind.direction	Wind direction	16 directions
precipitation.10min	10-min precipitation	mm
precipitation.1h	1-hour precipitation	mm
precipitation.3h	3-hour precipitation	mm
precipitation.24h	24-hour precipitation	mm
sunshine.1h	1-hour sunshine	hours
snow.depth	Snow depth	cm
snow.1h/6h/12h/24h	Snowfall	cm

Station Types

Type	Description
A	Staffed observatory (官署)
B	Special regional weather station (特別地域気象観測所)
C	AMeDAS station (アメダス)
D	Rain gauge station (雨量観測所)
E	Snow depth station (積雪観測所)
F	Regional rain station (地域雨量観測所)

Examples

Get current weather in Tokyo

Tool: get_current_weather
Arguments: {"station_code": "44132"}

Get weather by coordinates

Tool: get_weather_by_location
Arguments: {"lat": 35.6812, "lon": 139.7671}

Get forecast for Tokyo

Tool: get_forecast
Arguments: {"prefecture": "tokyo"}

Get historical weather data

Tool: get_historical_weather
Arguments: {"station_code": "44132", "datetime": "2025-12-01 12:00"}

Get time series data (last 24 hours)

Tool: get_weather_time_series
Arguments: {"station_code": "44132", "hours": 24, "interval_minutes": 60}

Data Availability

Data Type	Availability
Real-time observation	~30 min delay
Historical data	Past 1-2 weeks
Time series	Up to 168 hours (1 week)
Forecast	7 days ahead

License

MIT