Weather Server MCP Server H72

🚀 天氣服務器 MCP 服務器

本項目是一個測試天氣服務器的工具，基於 TypeScript 構建的 MCP 服務器，實現了一套天氣信息系統。它通過帶有 URI 和元數據的天氣數據資源、獲取與更新天氣信息的工具以及生成天氣摘要提示等方式，生動演示了核心 MCP 概念。

🚀 快速開始

本項目是一個基於 TypeScript 的 MCP 服務器，實現了天氣信息系統，可通過特定工具獲取、更新天氣信息並生成摘要。

✨ 主要特性

資源

• 可列出並通過 weather:// URI 訪問天氣數據。
• 每個天氣條目包含位置、溫度和元數據。
• 採用 JSON MIME 類型進行結構化數據訪問。

工具

• fetch_weather：用於獲取當前天氣信息。
  • 必須傳入位置作為參數。
  • 從外部 API 獲取天氣數據。
• update_weather：用於更新天氣信息。
  • 必須傳入位置和新天氣數據作為參數。
  • 更新服務器狀態中的天氣數據。

提示

• summarize_weather：生成當前天氣數據的摘要。
  • 包含所有天氣條目作為嵌入資源。
  • 返回結構化提示供 LLM 進行摘要處理。

📦 安裝指南

開發環境依賴安裝

npm install

環境文件配置

將 .envexample 重命名為 .env：

mv .envexample .env

在 .env 文件中更新 OPENWEATHER_API_KEY：

OPENWEATHER_API_KEY=您的自有 OpenWeather API 密鑰

服務器構建

npm run build

開發模式（自動重建）

npm run watch

與 Claude Desktop 集成

要與 Claude Desktop 配合使用，需添加服務器配置：

• 在 MacOS 上：~/Library/Application Support/Claude/claude_desktop_config.json
• 在 Windows 上：%APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "weatherserver": {
      "command": "/path/to/weatherserver/build/index.js"
    }
  }
}

調試建議

由於 MCP 服務器通過 stdio 進行通信，調試可能具有一定挑戰性。我們推薦使用 MCP Inspector，它可作為包腳本使用：

npm run inspector

Inspector 將提供一個可訪問瀏覽器調試工具的 URL。