IBM wxflows MCP Server

Model Context Protocol (MCP) での watsonx.ai Flows Engine の使用

ここでは、wxflows を使用したプロジェクトのセットアップとデプロイに関するステップバイステップのチュートリアルを紹介します。必要なツールのインストール、アプリのデプロイ、ローカルでの実行が含まれます。

この例は、以下の要素で構成されています。

• MCP TypeScript SDK (MCP サーバー)
• wxflows SDK (ツール)

任意のサポートされている MCP クライアントを使用できます。

このガイドでは、wxflows CLI のインストール、プロジェクトの初期化とデプロイ、アプリケーションのローカル実行について説明します。wxflows を使用したツール呼び出しの例として、google_books ツールと wikipedia ツールを使用します。

始める前に

このリポジトリをクローンし、適切なディレクトリを開きます。

git clone https://github.com/IBM/wxflows.git
cd examples/mcp/javascript

ステップ 1: wxflows のセットアップ

watsonx.ai Flows Engine を使用した AI アプリケーションの構築を開始する前に、以下を行います。

1. 無料アカウントにサインアップします
2. Node.js CLI をダウンロードしてインストールします
3. アカウントを認証します

ステップ 2: Flows Engine プロジェクトのデプロイ

wxflows ディレクトリに移動します。

cd wxflows

このリポジトリには、以下の値を持つ wxflows プロジェクトが既にセットアップされています。

• プロジェクトのエンドポイント api/mcp-example を定義します。
• 書籍を検索し、フィールド books|book を指定するための説明を含む google_books ツールをインポートします。
• Wikipedia 検索とフィールド search|page を指定するための説明を含む wikipedia ツールをインポートします。

以下のコマンドを実行して、このツール構成を Flows Engine エンドポイントにデプロイできます。

wxflows deploy

このコマンドは、定義されたエンドポイントとツールをデプロイし、これらはアプリケーション内で wxflows SDK によって使用されます。

ステップ 3: 環境変数の設定

プロジェクトのルートディレクトリから、サンプル環境ファイルをコピーして .env ファイルを作成します。

cp .env.sample .env

.env ファイルを編集し、API キーやその他の必要な環境変数などの認証情報を追加します。ツールが認証され、外部サービスと対話できるように、認証情報が正しいことを確認してください。

ステップ 4: アプリケーションの依存関係のインストール

アプリケーションを実行するには、必要な依存関係をインストールする必要があります。

npm i

このコマンドは、@wxflows/sdk パッケージやプロジェクトで指定された依存関係を含む、必要なすべてのパッケージをインストールします。

ステップ 5: MCP サーバーのビルド

以下を実行してサーバーをビルドします。

npm run build

ステップ 6: MCP クライアントでの使用

最後に、クライアントで MCP サーバーを使用できます。Claude Desktop で使用するには、サーバー設定を追加します。

MacOS の場合: ~/Library/Application Support/Claude/claude_desktop_config.json Windows の場合: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "wxflows-server": {
      "command": "node",
      "args": ["/path/to/wxflows-server/build/index.js"],
      "env": {
        "WXFLOWS_APIKEY": "YOUR_WXFLOWS_APIKEY",
        "WXFLOWS_ENDPOINT": "YOUR_WXFLOWS_ENDPOINT"
      }
    }
  }
}

これで Claude Desktop を開くと、wxflows-server のツールが一覧表示されるはずです。Claude Desktop を通じて google_books ツールと wikipedia ツールをテストできるようになりました。

まとめ

これで、google_books ツールと wikipedia ツールを使用した wxflows プロジェクトのセットアップ、デプロイ、実行が正常に完了しました。このセットアップは、データ取得に外部ツールを活用するための柔軟な環境を提供し、wxflows を使用してアプリをさらに構築および拡張できます。ツールを追加したり、データベース、NoSQL、REST、または GraphQL API から独自のツールを作成したりする手順については、ツールを参照してください。

サポート

ご質問やフィードバックがある場合は、Discord でお問い合わせください。ご連絡をお待ちしております。

インストール

Claude Desktop で使用するには、サーバー設定を追加します。

MacOS の場合: ~/Library/Application Support/Claude/claude_desktop_config.json Windows の場合: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "weather-server": {
      "command": "/path/to/weather-server/build/index.js"
    }
  }
}

デバッグ

MCP サーバーは標準入出力を介して通信するため、デバッグが難しい場合があります。パッケージスクリプトとして利用可能な MCP Inspector の使用をお勧めします。

npm run inspector

Inspector は、ブラウザでデバッグツールにアクセスするための URL を提供します。