MCP Server Get Weather

🚀 天氣 MCP 服務器

一個使用 Model Context Protocol (MCP) 構建的簡單天氣信息服務平臺，可通過簡單的 API 接口，提供全球各地城市的天氣信息查詢服務。

🚀 快速開始

Weather MCP Server 提供全球各地城市的天氣信息查詢服務，通過簡單的 API 接口實現。它利用 Model Context Protocol（MCP）與客戶端進行通信，便於與 AI 助手和其他兼容 MCP 的應用程序集成。

✨ 主要特性

• 通過城市名稱獲取當前天氣狀況。
• 返回溫度、天氣描述、溼度和風速信息。
• 外部 API 不可用時，提供生成數據作為備用方案。
• 簡單輕量的實現方式。

🔧 技術細節

本項目使用的技術棧如下：

📦 安裝指南

1. 克隆倉庫：

git clone https://github.com/Annihilater/mcp-server-get-weather

2. 安裝依賴項：

npm install

3. 構建項目：

npm run build

💻 使用示例

基礎用法

啟動服務器：

npx @modelcontextprotocol/inspector node dist/index.js

高級用法

要在 Cursor 中使用此天氣服務，需在 ~/.cursor/mcp.json 文件中添加以下配置：

"mcp-server-get-weather": {
  "command": "node",
  "args": [
    "<your-project-path>/dist/index.js"
  ]
}

將 <your-project-path> 替換為實際項目路徑。配置完成後，可通過 MCP 工具調用 mcp_mcp_server_get_weather_get_weather 函數獲取天氣信息。

示例

📚 詳細文檔

API 參考

get_weather

獲取指定城市的天氣信息。

參數

響應

返回一個 JSON 對象，結構如下：

{
  "city": "London",
  "current_condition": {
    "temperature": "15",
    "weatherDesc": "部分多雲",
    "humidity": "71",
    "windSpeed": "11",
    "observation_time": "下午 06:53"
  },
  "forecast": {
    "maxTemp": "16",
    "minTemp": "9",
    "sunHour": "7.4",
    "date": "2023-04-12"
  }
}

開發信息

可用腳本命令

• npm run build - 構建項目並生成可執行入口。
• npm run watch - 監控文件變化，自動重建。
• npx @modelcontextprotocol/inspector node dist/index.js - 啟動服務器。

項目結構

• src/index.ts - 入口文件，設置 MCP 服務器並使用 stdio 運輸。
• src/server.ts - 服務器實現文件，定義天氣工具。

📄 許可證

本項目採用 MIT 許可證。