Integrations

Uses environment variables for configuration and authentication with Wordware API credentials

ワードウェア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 互換クライアント

インストール

# Clone the repository
git clone https://github.com/yourusername/wordware-mcp.git
cd wordware-mcp

# Create a virtual environment
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

# Set up environment variables
cp .env.example .env
# Edit .env with your Wordware API credentials

構成

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

{
  "tools": [
    {
      "id": "your-tool-id-1"
    },
    {
      "id": "your-tool-id-2"
    },
    {
      "id": "your-tool-id-3"
    }
  ]
}

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

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

サーバーの実行

# Run with default settings
python server.py

# Run with debug logging
python server.py --debug

# Run with SSE transport on a specific port
python server.py --transport sse --host 127.0.0.1 --port 8000

# Or install in Claude Desktop
mcp install python server.py --name "Wordware Tools"

仕組み

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ファイルに正しく設定されていることを確認してください
パラメータ検証エラー: 入力形式がツールの要件と一致していることを確認してください
イベントループエラー: 「イベントループが閉じられました」というエラーが表示された場合は、サーバーを再起動してください。

発達

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

# Run with debug logging
python server.py --debug

# Check the logs for detailed information
tail -f /path/to/your/logs/mcp.log

貢献

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

ライセンス

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

謝辞

モデルコンテキストプロトコルのAnthropic
エージェントプラットフォーム用のWordware
プロトコル実装用のMCP Python SDK

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

Claude などの AI アシスタントと Wordware の特殊なエージェント機能を橋渡しするモデルコンテキストプロトコルサーバー。標準化されたインターフェースを通じて、あらゆる Wordware フローへの動的な読み込みとアクセスが可能になります。