🌤️ MCP 天气服务器 (Cursor + Node.js + WSL)

本项目是一个简单的 模型上下文协议 (MCP) 服务器，它使用 OpenWeatherMap API 提供实时天气数据，使用 Node.js 构建，并设计为在 WSL (Windows Subsystem for Linux) 中运行。

📦 功能

• 暴露一个 MCP 工具：getWhetherByCityName
• 使用 OpenWeatherMap 获取任何城市的天气数据
• 兼容 Cursor AI 客户端
• 支持 WSL，具有干净的 .env 配置

---

🛠️ 前提条件

• 已安装 Cursor
• 已启用 WSL，并安装 Ubuntu 或其他 Linux 发行版
• 在 WSL 中安装了 Node.js 和 npm
• OpenWeatherMap API 密钥

---

🔧 安装

# 在 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 中，使用 demo 服务器创建一个新的 MCP 客户端。然后运行如下查询：

getWhetherByCityName({ name: "London" })

服务器将返回该城市当前的的天气数据。

---

📂 文件结构

mcp-poc/
├── index.js           # MCP 服务器入口点
├── .env               # 您的 API 密钥
├── package.json
└── README.md

---

📜 许可证

MIT

---

✨ 鸣谢

• OpenWeatherMap API
• 模型上下文协议 (MCP)
• Cursor