Caiyun Weather

🚀 集成指南

本集成指南將幫助你集成彩雲天氣API，使用Claude Desktop獲取天氣信息。通過以下步驟，你可以輕鬆安裝所需工具、配置開發環境並使用提供的工具請求天氣數據。

📦 安裝指南

⚠️ 重要提示

在開始之前，請確保你已經獲取了API訪問權限。可以在https://docs.caiyunapp.com/weather-api/申請。

首先，你需要安裝uv工具，不同系統的安裝命令如下：

MacOS/Linux系統

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows系統

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

使用Claude Desktop進行配置

在claude_desktop_config.json文件中添加以下內容，具體路徑可通過：Hamburger Menu -> File -> Settings -> Developer -> Edit Config找到。

{
  "mcpServers": {
    "caiyun-weather": {
      "command": "uvx",
      "args": ["mcp-caiyun-weather"],
      "env": {
        "CAIYUN_WEATHER_API_TOKEN": "YOUR_API_KEY_HERE"
      }
    }
  }
}

💻 使用示例

請求天氣信息示例

詢問Claude關於天氣的問題，例如：“北京現在的天氣如何？”

🛠️ 開發環境配置指南

使用Claude Desktop進行配置

在claude_desktop_config.json文件中添加以下內容，具體路徑可通過：Hamburger Menu -> File -> Settings -> Developer -> Edit Config找到。

{
  "mcpServers": {
    "caiyun-weather": {
      "command": "uv",
      "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/PARENT/FOLDER/mcp-caiyun-weather",
        "run",
        "mcp-caiyun-weather"
      ],
      "env": {
        "CAIYUN_WEATHER_API_TOKEN": "YOUR_API_TOKEN_HERE"
      }
    }
  }
}

調試步驟

運行以下命令進行調試：

npx @modelcontextprotocol/inspector \
      uv \
      --directory /ABSOLUTE/PATH/TO/PARENT/FOLDER/mcp-caiyun-weather \
      run \
      mcp-caiyun-weather

🛠️ 可用工具

以下是一些可用的工具及其使用說明：

⚠️ 重要提示

所有工具的使用均需提供地理位置的經緯度參數，並依賴有效的API令牌進行調用。