Japanese Weather MCP

🚀 日本天氣MCP服務器

這是一個基於模型上下文協議（MCP）的服務器，藉助 weather.tsukumijima.net 提供的API，為用戶提供日本天氣的預報信息。

🚀 快速開始

本服務器可幫助你輕鬆獲取日本各城市的天氣信息，支持多種操作工具，讓天氣查詢變得簡單高效。

✨ 主要特性

• 🌤️ 獲取日本各城市的天氣預報。
• 📍 支持日本主要城市（東京、大阪、京都等）。
• 📊 提供詳細的天氣信息，包括溫度、降水概率和風力狀況。
• 🏢 數據來源於日本氣象廳。
• 🔧 提供易於使用的MCP工具進行天氣查詢。

📦 安裝指南

通過Smithery安裝

若要通過 Smithery 為Claude Desktop自動安裝 japanese-weather-mcp，可使用以下命令：

npx -y @smithery/cli install @kongyo2/japanese-weather-mcp --client claude

手動安裝

1. 克隆此倉庫：

git clone https://github.com/kongyo2/Japanese-Weather-MCP
cd weather-mcp-server

2. 安裝依賴：

npm install

3. 構建項目：

npm run build

💻 使用示例

開發模式

在開發模式下運行服務器：

npm run dev

生產模式

構建並運行服務器：

npm run build
npm start

📚 詳細文檔

可用工具

1. get_weather_forecast

通過城市ID獲取日本任何城市的天氣預報。 參數：

• cityId（字符串）：日本城市的城市ID（例如，東京的ID為 '130010'）

示例：

{
  "cityId": "130010"
}

2. get_available_city_ids

獲取常見日本城市的可用城市ID列表。 參數：無 返回：包含可用城市ID及其對應名稱的列表。

3. get_weather_by_city_name

通過城市名稱獲取常見日本城市的天氣預報。 參數：

• cityName（枚舉）：日本城市的名稱
  • 選項：東京（TOKYO）、大阪（OSAKA）、京都（KYOTO）、福岡（FUKUOKA）、札幌（SAPPORO）、名古屋（NAGOYA）、橫濱（YOKOHAMA）、神戶（KOBE）、川崎（KAWASAKI）、廣島（HIROSHIMA）

示例：

{
  "cityName": "TOKYO"
}

常見城市ID

如需更多城市ID，請訪問：https://weather.tsukumijima.net/primary_area.xml

天氣數據結構

天氣預報包括：

• 基本信息：

  • 發佈時間和發佈機構
  • 位置詳情（都道府縣、城市、地區）

• 三天預報數據：

  • 天氣狀況（天氣描述）
  • 溫度（攝氏度和華氏度的最高/最低溫度）
  • 降水概率（6小時間隔）
  • 詳細天氣信息
  • 風力狀況
  • 浪高（沿海地區）

• 附加信息：

  • 天氣圖標（SVG格式）
  • 日本氣象廳官方天氣頁面鏈接

API來源

此MCP服務器使用 weather.tsukumijima.net 提供的API，該API具有以下特點：

• 兼容Livedoor Weather API格式
• 數據來自日本氣象廳
• 無需API密鑰
• 免費使用

速率限制

請遵守以下API使用規則：

• 使用自定義的User-Agent頭
• 避免快速連續請求
• 請求間隔至少保持0.5秒

錯誤處理

服務器具備全面的錯誤處理機制，可處理以下情況：

• 網絡連接問題
• 無效的城市ID
• API服務不可用
• 數據解析錯誤

開發

項目結構

weather-mcp-server/
├── src/
│   ├── server.ts          # 主要的MCP服務器實現
│   └── weather-api.ts     # 天氣API客戶端
├── package.json
├── tsconfig.json
└── README.md

構建

npm run build

測試

npm test

代碼檢查

npm run lint

代碼格式化

npm run format

📄 許可證

本項目採用MIT許可證，詳情請參閱 LICENSE 文件。

貢獻指南

1. Fork此倉庫
2. 創建功能分支
3. 進行修改
4. 如有必要，添加測試
5. 提交拉取請求

致謝

• weather.tsukumijima.net 提供天氣API
• 日本氣象廳提供天氣數據
• FastMCP 提供MCP框架

支持

若你遇到任何問題或有疑問，請按以下步驟操作：

1. 查看 weather.tsukumijima.net文檔
2. 檢查可用的城市ID
3. 確保遵守速率限制
4. 在本倉庫中創建一個問題