🌤️ MCP Weather Server (Cursor + Node.js + WSL)

🌤️ MCP 天气服务（Cursor + Node.js + WSL）

这是一个简单的 Model Context Protocol（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 密钥

---

🔧 安装

# In WSL terminal
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（或设置界面）中使用以下配置：

{
  "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 server entrypoint
├── .env               # Your API key
├── package.json
└── README.md

---

📜 许可证

MIT

---

✨ 致谢

• OpenWeatherMap API
• Model Context Protocol（MCP）
• Cursor