JMA Data MCP

JMA数据MCP

日本气象厅（JMA）数据MCP服务器。

特性

• AMeDAS（自动气象数据采集系统）站数据
• 日本全国1286个观测站
• 按车站代码、名称或位置搜索
• 实时天气观测数据（温度、湿度、风、降水等）
• 历史天气数据（过去1-2周）
• 用于趋势分析的时间序列数据
• 各地区天气预报

数据源

• AMeDAS站数据：https://www.jma.go.jp/bosai/amedas/
• 实时观察：https://www.jma.go.jp/bosai/amedas/
• 天气预报：https://www.jma.go.jp/bosai/forecast/

安装

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

或在本地安装：

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

CLI使用情况

jma-data-mcp 现在支持MCP服务器模式和CLI模式：

• 无参数：启动MCP服务器（向后兼容）
• serve：显式启动MCP服务器
• 子命令：运行CLI并打印JSON输出

例子

# Backward-compatible MCP server startup
jma-data-mcp

# Explicit MCP server startup
jma-data-mcp serve

# Station info
jma-data-mcp station get --code 44132

# Nearby stations
jma-data-mcp station nearby --lat 35.6812 --lon 139.7671 --radius-km 10

# Current weather
jma-data-mcp weather current --station-code 44132

# Forecast
jma-data-mcp forecast get --prefecture tokyo

# Historical data
jma-data-mcp history get --station-code 44132 --target-datetime "2025-12-01 12:00"

CLI命令列表

• jma-data-mcp serve
• jma-data-mcp station get --code
• jma-data-mcp station search --name
• jma-data-mcp station nearby --lat --lon [--radius-km ]
• jma-data-mcp station type --station-type
• jma-data-mcp station list [--limit ] [--offset ]
• jma-data-mcp weather current [--station-code ]
• jma-data-mcp weather by-location --lat --lon
• jma-data-mcp forecast get --prefecture
• jma-data-mcp forecast list-prefectures
• jma-data-mcp history get --station-code --target-datetime ""
• jma-data-mcp history series --station-code [--hours ] [--interval-minutes ]

Windows可执行文件

Windows独立可执行文件发布在GitHub版本中：

• 资产： jma-data-mcp.exe
• 校验和文件： SHA256SUMS.txt

MCP服务器配置

克劳德桌面

增添 ~/Library/Application Support/Claude/claude_desktop_config.json （macOS）或 %APPDATA%\Claude\claude_desktop_config.json （Windows）：

已安装版本：

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

直接来自GitHub：

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

地方发展：

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

光标

增添 .cursor/mcp.json 在项目根目录中：

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

克莱恩

添加到临床MCP设置：

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

可用工具

车站工具

• get_station_info -按代码获取电台
• search_stations -按名称搜索电台
• search_nearby_stations -半径范围内的搜索站
• get_stations_of_type -按类型获取电台（A-F）
• list_stations -列出所有带页码的电台

天气工具

• get_current_weather -从AMeDAS获取当前天气观测
• get_weather_by_location -从最近的气象站获取天气坐标
• get_forecast -获取一个县的天气预报
• list_prefectures -列出可用的县代码

历史数据工具

• get_historical_weather -获取特定过去日期/时间的天气数据（可用约1-2周）
• get_weather_time_series -获取时间序列数据以进行趋势分析（最长1周的每小时数据）

天气数据

这 get_current_weather 工具返回：

车站类型

AMeDAS station（Amedas） | D | Rain gauge station（雨量観测所）| | E | Snow depth station（积雪観测所）| | F | Regional rain station（地域雨量観测所）|

例子

获取东京当前天气

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

通过坐标获取天气

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

获取东京天气预报

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

获取历史天气数据

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

获取时间序列数据（过去24小时）

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

数据可用性

发布

推送版本标签以触发自动Windows构建和GitHub Release上传：

git tag v0.2.0
git push origin v0.2.0

发布工作流发布：

• jma-data-mcp.exe
• SHA256SUMS.txt

许可证

麻省理工学院