Workflows MCP Server

🚀 ワークフロー MCP サーバー

このサーバーは、Model Context Protocol (MCP) を使用して、簡単な API を通じて都市の天気情報を提供するサーバーです。

✨ 主な機能

• このサーバーは、ワークフローをツールとしてエージェントに公開しています。この実装では、get-weather というツールを公開しており、任意の都市の天気情報を取得できます。
• check-weather というプロンプトテンプレートを提供しており、大規模言語モデル (LLM) との統合を容易にします。
• HTTP/SSE 伝送プロトコルを使用してクライアントと通信します。

📦 インストール

前提条件

• Node.js 18 以上
• npm または yarn

手順

1. このリポジトリをクローンします。
2. 依存関係をインストールします。

   npm install
   

💻 使用例

簡易 API 方式

1. サーバーを起動します。

   node direct-server.js
   

2. サーバーはポート 3000 で起動し、以下の機能を提供します。
   • 天気 API: http://localhost:3000/api/weather?city=New%20York
   • ヘルスチェック: http://localhost:3000/health
3. クライアントのサンプルを実行します。

   node direct-client.js
   

MCP 方式

この方法では、TypeScript コードをビルドする必要があり、一部の互換性問題が発生する可能性があります。

1. プロジェクトをビルドします。

   npm run build
   

2. サーバーを起動します。

   npm start
   

3. サーバーはポート 3000 で起動し、以下のエンドポイントを提供します。
   • SSE エンドポイント: http://localhost:3000/sse
   • メッセージエンドポイント: http://localhost:3000/messages?connectionId=YOUR_CONNECTION_ID
   • ヘルスチェック: http://localhost:3000/health

接続 ID について

接続 ID は、クライアントが SSE エンドポイントに接続する際に生成される一意の識別子です。

• クライアントが /sse エンドポイントに接続すると、サーバーは一意の接続 ID を生成します。
• この ID は、初期の SSE レスポンスでクライアントに返されます。
• クライアントは、後続の /messages エンドポイントへのすべてのリクエストで、この ID をクエリパラメータとして含める必要があります。
• これにより、サーバーはレスポンスを正しいクライアントの SSE 接続にルーティングできます。

例えば、接続 ID が 1742761520489 の場合、以下のアドレスにツールを呼び出します。

http://localhost:3000/messages?connectionId=1742761520489

📚 ドキュメント

ワークフローアーキテクチャ

get-weather ツールを呼び出すと、以下のワークフローがトリガーされます。

1. 都市名を入力として受け取ります。
2. OpenWeatherMap サービスをクエリして、その場所の現在の天気データを取得します。
3. 生の天気データを LLM に渡して解釈します。
4. 友好的で自然な言語で記述された現在の天気状況を返します。

このアーキテクチャにより、正確な天気データの取得と高度な処理が可能になり、より会話的で理解しやすい形式で天気情報を提供できます。

現在の実装について

MCP プロトコルの実装に関連するいくつかの技術的な課題のため、2 つの方法を提供しています。

1. オリジナルの MCP サーバー - src ディレクトリ内の TypeScript 実装ですが、現在の SDK バージョンとの互換性問題がある可能性があります。
2. 簡易な直接 API - ルートディレクトリ (direct-server.js と direct-client.js) 内の簡単な JavaScript 実装で、MCP プロトコルを使用しない RESTful エンドポイントを提供します。

機能をすぐに実装するためには、簡易な直接 API 方式をお勧めします。

📄 API リファレンス

直接 API

GET /api/weather

指定された都市の天気情報を取得します。

パラメータ:

• city (必須) - 都市名

戻り値:

• 温度、湿度などの天気データ

MCP サーバー

この部分のドキュメントはまだ整備されていません。近々詳細な情報を提供する予定です。