🚀 🌤️ 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