MCP Weather Server Tke

🚀 MCP 天気サーバー

このサーバーは、TypeScript で実装された Model Context Protocol (MCP) を用い、Server-Sent Events (SSE) プロトコルを通じて天気情報ツールを提供します。

🚀 クイックスタート

このサーバーは、モデルコンテキストプロトコルを実装し、SSE 輸送プロトコルを通じてユーザーに天気予報と警報ツールを提供します。通常、ローカル通信であるstdio標準例とは異なり、このサーバーはHTTPを通じてリモート接続を実現する方法を示し、クライアントがネットワークを介して接続できるようにします。

✨ 主な機能

• SSE 輸送プロトコルに基づく MCP を実装
• 2つの天気ツールを提供：
  • get-forecast：特定の座標地点の天気予報を取得
  • get-alerts：米国各州のアクティブな天気警報を取得
• 米国国家気象局（NWS）APIに接続
• 複数のクライアント接続をサポート

📦 インストール

前提条件

• Node.js (v16 以上)
• npm または yarn パッケージマネージャー

インストール手順

# リポジトリをクローン
git clone https://github.com/tyfeng1997/mcp-server.git
cd mcp-server

# 依存関係をインストール
npm install

# TypeScript コードをコンパイル
npm run build

💻 使用例

基本的な使用法

サーバーを起動するには、以下のコマンドを実行します。

node build/index.js

これにより、デフォルトでポート 3001 でサーバーが起動します。以下のような出力が表示されます。

天気 MCP サーバーが http://localhost:3001 で実行中です
クライアントは http://localhost:3001/sse に接続してください

利用可能なツール

このサーバーは2つのツールを提供しています。

1. get-forecast

   • 説明：特定の位置の天気予報を取得します。
   • パラメータ：
     • latitude（number）：位置の緯度 (-90 から 90)
     • longitude（number）：位置の経度 (-180 から 180)
   • 注意：米国地域の NWS API のみサポートしています。

2. get-alerts

   • 説明：特定の州の天気警報を取得します。
   • パラメータ：
     • state（string）：2文字の米国州コード（例：CA、NY）

サーバーのテスト

以下のコマンドを使用して、サーバーが正常に動作しているかをテストできます。

curl http://localhost:3001/sse

これにより、セッション ID を含むイベントが返されます。

📚 ドキュメント

パートナークライアント

このサーバーは、MCP クライアントと連携するように設計されています。クライアントは tyfeng1997/mcp-client で入手できます。クライアントはこのサーバーに接続し、Claude などのAIアシスタントが自然言語で天気ツールを使用できるようにします。

カスタム設定

ポート設定

ポートを変更するには、コード内の PORT 定数を変更します。

const PORT = 3001; // 必要なポートに変更

追加ツールの追加

以下のパターンを使用して、追加のツールを追加できます。

server.tool(
  "your-tool-name",
  "あなたのツールの説明",
  {
    // パラメータスキーマには zod を使用
    param1: z.string().describe("パラメータの説明"),
    param2: z.number().describe("パラメータの説明"),
  },
  async ({ param1, param2 }) => {
    // ツールの実装
    return {
      content: [
        {
          type: "text",
          text: "ツールの結果",
        },
      ],
    };
  }
);

🤝 貢献ガイド

貢献を歓迎します！自由に Pull Request を送信してください。

📄 ライセンス

このプロジェクトは MIT ライセンスの下で公開されています。詳細は LICENSE ファイルを参照してください。