MCP Whether Server

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

这是一个简单的模型上下文协议 (MCP) 服务器，借助OpenWeatherMap API提供实时天气数据。它基于Node.js构建，专为在WSL（Windows 子系统 Linux）中运行而设计，能为用户带来便捷的天气信息服务。

🚀 快速开始

在开始使用本 MCP 天气服务器前，请确保满足“🛠️ 先决条件”中的各项要求，完成安装和环境配置后，即可运行服务器获取天气数据。

✨ 主要特性

• 提供一个 MCP 工具：getWhetherByCityName
• 可使用 OpenWeatherMap 获取任意城市的天气数据
• 与 Cursor AI 客户端兼容
• 支持 WSL，带有干净的 .env 配置文件

🛠️ 先决条件

• 已安装 Cursor
• WSL 启用（如 Ubuntu 或其他 Linux 发行版）
• Node.js 和 npm 在 WSL 中已安装
• 拥有 OpenWeatherMap API 密钥

📦 安装指南

在 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