MCP Whether Server

🚀 🌤️ MCP 天氣服務器（Cursor + Node.js + WSL）

這是一個簡單的模型上下文協議 (MCP) 服務器，藉助OpenWeatherMap API，為用戶提供即時天氣數據。它基於Node.js構建，專為在WSL（Windows 子系統 Linux）中運行而設計，能有效滿足用戶對天氣信息的即時獲取需求。

🚀 快速開始

你可以按照以下步驟快速搭建並運行 MCP 天氣服務器：

1. 完成先決條件的準備，包括安裝 Cursor、啟用 WSL、在 WSL 中安裝 Node.js 和 npm 以及獲取 OpenWeatherMap API 密鑰。
2. 進行服務器的安裝和環境設置。
3. 配置 Cursor 中的 MCP 信息。
4. 運行服務器併發起查詢。

✨ 主要特性

• 提供 MCP 工具 getWhetherByCityName，方便獲取天氣數據。
• 藉助 OpenWeatherMap 可獲取任意城市的天氣數據。
• 與 Cursor AI 客戶端兼容，便於集成使用。
• 支持 WSL，且帶有簡潔的 .env 配置文件，易於部署。

📦 安裝指南

在 WSL 終端中執行以下命令進行安裝：

# 在 WSL 終端中運行
git clone https://github.com/your-username/mcp-weather-server
cd mcp-weather-server
npm install

🔐 環境設置

在項目根目錄下創建一個 .env 文件，並添加如下內容：

WHETHER_API_KEY=your_openweather_api_key_here

🌱 重要提示：服務器將使用 dotenv 讀取此密鑰。

🧠 MCP 配置（在 Cursor 中）

在你的 Cursor 的 mcp.json（或設置 UI）中，使用以下配置：

{
  "mcpServers": {
    "demo": {
      "command": "wsl",
      "args": ["node", "/home/kaif/code/learnings/mcp-poc/index.js"]
    }
  }
}

⚠️ 重要提示：當使用 wsl 時，env 密鑰可能無法正常工作。請改用 .env 文件。

💻 使用示例

基礎用法

在 Cursor 中創建一個新的 MCP 客戶端，使用 demo 服務器。然後運行以下查詢：

getWhetherByCityName({ name: "London" })

服務器將返回指定城市（如倫敦）的當前天氣數據。

📂 文件結構

mcp-poc/
├── index.js           # MCP 服務器入口文件
├── .env               # 你的 API 密鑰
├── package.json
└── README.md

📄 許可證

本項目採用 MIT 許可證。

✨ 致謝

• OpenWeatherMap API
• 模型上下文協議 (MCP)
• Cursor