ワードウェアMCP

Wordware の強力なエージェント機能を Claude やその他の MCP 互換 AI アシスタントと統合する Model Context Protocol (MCP) サーバー。

概要

このプロジェクトは、Anthropicのモデルコンテキストプロトコル（MCP）を介して、ClaudeのようなAIアシスタントとWordwareの専用エージェント機能との橋渡しを行います。この統合により、設定に基づいてWordware APIからツールが動的に読み込まれ、ClaudeはWordwareのあらゆる専用フローにアクセスできるようになります。

特徴

• 🔄 動的ツール読み込み- 設定に基づいて Wordware API からツールを自動的に読み込みます

• 🧠 インテリジェントなスキーマ検出- さまざまなツールの入力スキーマを自動的に検出して適応します

• 🔍 高度なパラメータ処理- さまざまな入力形式（JSON、ネスト構造、文字列）を処理

• ⚙️ 堅牢なエラー処理- 包括的なエラーログとイベントループ管理

• 🔑 シンプルな認証- Wordwareアカウントを接続するための簡単なセットアップ

前提条件

• Python 3.8以上

• Wordware API 認証情報

• Claude Desktop またはその他の MCP 互換クライアント

インストール

構成

次の構造のtools_config.jsonファイルを作成します。

この設定ファイルでは任意のWordwareツールIDを指定できます。サーバーはそれらを動的に読み込み、MCPツールとして登録します。入力スキーマや説明などのツールメタデータは、Wordware APIから直接取得されます。

カスタム構成ファイルのパスを指定するには、 CONFIG_PATH環境変数を使用します。

サーバーの実行

仕組み

Wordware MCP サーバーは次のように動作します。

1. ツール構成の読み込み- 構成ファイルからツールIDのリストを読み取ります

2. 動的ツール登録- ツールIDごとに:

   • Wordware APIからメタデータを取得します

   • 入力スキーマ要件を検出する

   • 対応するMCPツール関数を作成する

   • ツールをMCPサーバーに登録する

3. リクエスト処理- ツールが呼び出されると:

   • さまざまな形式（JSON オブジェクト、文字列、ネストされた構造）の入力パラメータを処理します。

   • ツールの要件に基づいてパラメータ形式を適応させる

   • 適切にフォーマットされたリクエストをWordware APIに送信します

4. レスポンス処理- Wordware API レスポンスを処理します。

   • サーバー送信イベント（SSE）ストリームを解析します

   • すべての出力値を収集する

   • クロードへの応答をユーザーフレンドリーな方法でフォーマットします

高度な機能

インテリジェントなパラメータ処理

サーバーはさまざまな入力パラメータ形式を自動的に処理します。

• 直接パラメータ: {"Full Name": "John Doe", "Company": "Acme Inc."}

• kwargs 内の JSON 文字列: {"kwargs": "{\"Full Name\": \"John Doe\", \"Company\": \"Acme Inc.\"}"}

• ネストされたパラメータ: {"kwargs": {"Full Name": "John Doe", "Company": "Acme Inc."}}

入力スキーマ検出

サーバーは各ツールの入力スキーマを分析して正しい形式を決定します。

• ツールがkwargsオブジェクトでラップされたパラメータを必要とするかどうかを検出します

• より良いドキュメント化のために内部プロパティを抽出します

• 各ツールのパラメータ形式を自動的に適応します

エラー処理と回復

堅牢なエラー処理には以下が含まれます。

• イベントループの監視と回復

• すべてのリクエストとレスポンスの詳細なログ

• HTTPエラーとタイムアウトの適切な処理

• トラブルシューティングのための包括的なエラーメッセージ

トラブルシューティング

• Claude Desktopにツールが表示されない: サーバーが実行中であり、Claude Desktopの設定に正しく登録されていることを確認してください

• 認証エラー: Wordware APIキーが.envファイルに正しく設定されていることを確認してください

• パラメータ検証エラー: 入力形式がツールの要件と一致していることを確認してください

• イベントループエラー: 「イベントループが閉じられました」というエラーが表示された場合は、サーバーを再起動してください。

発達

サーバーを拡張または変更するには:

貢献

貢献を歓迎します！お気軽にプルリクエストを送信してください。

ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細については LICENSE ファイルを参照してください。

謝辞

• モデルコンテキストプロトコルのAnthropic

• エージェントプラットフォーム用のWordware

• プロトコル実装用のMCP Python SDK