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

🌤️ MCP 天気サーバー（Cursor + Node.js + WSL）

このプロジェクトは、Node.js で構築され、WSL（Windows Subsystem for Linux）内で動作するように設計された、OpenWeatherMap API を使用してリアルタイムの天気データを提供するシンプルな Model Context Protocol（MCP） サーバーです。

📦 機能

• MCP ツール getWhetherByCityName を公開します
• OpenWeatherMap を使用して、あらゆる都市の天気データを取得します
• Cursor AI クライアントと互換性があります
• .env によるシンプルな設定で WSL をサポートします

---

🛠️ 前提条件

• Cursor がインストールされていること
• Ubuntu またはその他の Linux ディストリビューションで WSL が有効になっていること
• 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（または設定 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 server entrypoint
├── .env               # Your API key
├── package.json
└── README.md

---

📜 ライセンス

MIT

---

✨ クレジット

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