MCP Whether Server

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

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

🚀 クイックスタート

この MCP 天気サーバーを使えば、OpenWeatherMap API を通じて任意の都市の天気データを取得できます。Cursor AI クライアントと互換性があり、WSL 上で簡単にセットアップできます。

✨ 主な機能

• MCP ツール getWhetherByCityName を提供します。
• OpenWeatherMap を利用して任意の都市の天気データを取得できます。
• Cursor AI クライアントと互換性があります。
• WSL をサポートし、きれいな .env 設定ファイルが用意されています。

🛠️ 前提条件

• Cursor がインストールされていること。
• WSL が有効になっていること（Ubuntu や他の Linux ディストリビューション）。
• Node.js と npm が WSL 内にインストールされていること。
• 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 で新しい MCP クライアントを作成し、demo サーバーを使用します。次に、以下のクエリを実行します。

getWhetherByCityName({ name: "London" })

サーバーは指定した都市の現在の天気データを返します。

📂 ファイル構成

mcp-poc/
├── index.js           # MCP サーバーのエントリーファイル
├── .env               # あなたの API キー
├── package.json
└── README.md

📄 ライセンス

MIT

✨ 謝辞

• OpenWeatherMap API
• モデルコンテキストプロトコル (MCP)
• Cursor