Weather MCP Ts

🚀 天氣MCP服務器

這是一個使用TypeScript開發的天氣MCP（模型上下文協議）服務器，可提供模擬天氣數據及相關功能。

✨ 主要特性

• 🌤️ 獲取當前天氣信息
• 📅 多日天氣預報
• ⚠️ 天氣預警系統
• 🔍 位置搜索功能
• 📊 天氣統計
• 🎭 支持模擬數據

📦 安裝指南

pnpm install

💻 使用示例

安裝與構建

# 安裝依賴
pnpm install

# 構建項目
pnpm run build

啟動方式

1. MCP協議（stdio）

# 用於MCP客戶端集成
pnpm start

2. HTTP API服務器 🆕

# 啟動HTTP服務器（默認端口8080）
pnpm run start:http

# 啟動HTTP服務器（指定端口3001）
pnpm run start:http:3001

# 或者直接指定端口
node dist/http-server.js 8080

3. 簡易HTTP服務器（推薦） 🚀

# 使用默認端口8080啟動
pnpm run start:simple

# 使用特定端口啟動
pnpm run start:simple:3000  # 開發端口
pnpm run start:simple:5000  # 備用端口
pnpm run start:simple:9000  # 高端口

# 或者使用serve命令
pnpm run serve              # 默認端口8080
pnpm run serve:dev          # 開發端口3000
pnpm run serve:prod         # 生產端口8080

# 或者直接指定任意端口
node dist/simple-http-server.js 4000

動態端口支持

簡易HTTP服務器支持動態端口配置：

# 使用任意你想要的端口
node dist/simple-http-server.js 3000
node dist/simple-http-server.js 5000
node dist/simple-http-server.js 9000
node dist/simple-http-server.js 12345

服務器將自動執行以下操作：

• 若未指定端口，默認使用8080端口
• 接受任何有效的端口號作為命令行參數
• 在啟動消息和文檔中顯示實際使用的端口

HTTP API使用示例

一旦HTTP服務器啟動，你可以通過以下方式使用它：

瀏覽器訪問

• 打開 http://localhost:8080 查看API文檔
• 直接點擊鏈接測試各種API

curl命令

# 獲取香港的當前天氣
curl "http://localhost:8080/weather?location=Hong Kong"

# 獲取東京的5天天氣預報
curl "http://localhost:8080/forecast?location=Tokyo&days=5"

# 獲取天氣預警
curl "http://localhost:8080/alerts?location=Hong Kong"

# 搜索位置
curl "http://localhost:8080/locations?q=kong"

# 獲取統計信息
curl "http://localhost:8080/stats"

JavaScript/Fetch

// 獲取天氣數據
const response = await fetch('http://localhost:8080/weather?location=Tokyo');
const weather = await response.json();
console.log(weather);

開發模式

# 監聽模式編譯
pnpm run dev

可用工具

1. get_current_weather

獲取指定位置的當前天氣信息

參數：

• location（字符串）：位置名稱

示例：

{
  "location": "Hong Kong"
}

2. get_weather_forecast

獲取指定位置的天氣預報

參數：

• location（字符串）：位置名稱
• days（數字，可選）：預報天數（1 - 7天，默認3天）

示例：

{
  "location": "Tokyo",
  "days": 5
}

3. get_weather_alerts

獲取天氣預警信息

參數：

• location（字符串，可選）：位置名稱

示例：

{
  "location": "Hong Kong"
}

4. search_locations

搜索支持的位置

參數：

• query（字符串）：搜索關鍵詞

示例：

{
  "query": "kong"
}

5. get_weather_stats

獲取天氣統計信息

參數： 無

支持的位置

目前支持以下位置的詳細天氣數據：

• 香港
• 東京、大阪、京都、廣島、札幌、福岡（日本）
• 倫敦（英國）
• 紐約（美國）
• 悉尼（澳大利亞）

其他位置將返回隨機生成的模擬數據。

🔧 技術細節

技術規格

項目結構

src/
├── index.ts              # MCP服務器主文件（stdio）
├── http-server.ts        # HTTP API服務器
├── simple-http-server.ts # 簡易HTTP服務器
├── weather-service.ts    # 天氣服務邏輯
├── mock-data.ts          # 模擬數據
└── types.ts              # TypeScript類型定義

HTTP API端點

📄 許可證

本項目採用MIT許可證。