ワードウェアMCP
Wordware の強力なエージェント機能を Claude やその他の MCP 互換 AI アシスタントと統合する Model Context Protocol (MCP) サーバー。
概要
このプロジェクトは、Anthropicのモデルコンテキストプロトコル（MCP）を介して、ClaudeのようなAIアシスタントとWordwareの専用エージェント機能との橋渡しを行います。この統合により、設定に基づいてWordware APIからツールが動的に読み込まれ、ClaudeはWordwareのあらゆる専用フローにアクセスできるようになります。
Related MCP server: Wordware MCP Server
特徴
🔄 動的ツール読み込み- 設定に基づいて Wordware API からツールを自動的に読み込みます
🧠 インテリジェントなスキーマ検出- さまざまなツールの入力スキーマを自動的に検出して適応します
🔍 高度なパラメータ処理- さまざまな入力形式（JSON、ネスト構造、文字列）を処理
⚙️ 堅牢なエラー処理- 包括的なエラーログとイベントループ管理
🔑 シンプルな認証- Wordwareアカウントを接続するための簡単なセットアップ
前提条件
Python 3.8以上
Wordware API 認証情報
Claude Desktop またはその他の MCP 互換クライアント
インストール
構成
次の構造のtools_config.jsonファイルを作成します。
この設定ファイルでは任意のWordwareツールIDを指定できます。サーバーはそれらを動的に読み込み、MCPツールとして登録します。入力スキーマや説明などのツールメタデータは、Wordware APIから直接取得されます。
カスタム構成ファイルのパスを指定するには、 CONFIG_PATH環境変数を使用します。
サーバーの実行
仕組み
Wordware MCP サーバーは次のように動作します。
ツール構成の読み込み- 構成ファイルからツールIDのリストを読み取ります
動的ツール登録- ツールIDごとに:
Wordware APIからメタデータを取得します
入力スキーマ要件を検出する
対応するMCPツール関数を作成する
ツールをMCPサーバーに登録する
リクエスト処理- ツールが呼び出されると:
さまざまな形式（JSON オブジェクト、文字列、ネストされた構造）の入力パラメータを処理します。
ツールの要件に基づいてパラメータ形式を適応させる
適切にフォーマットされたリクエストをWordware APIに送信します
レスポンス処理- 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