Wordware Research

🚀 Wordware MCP 辞書

Wordwareの強力なプロキシ機能とClaudeやその他のMCP互換AIアシスタントを統合したモデルコンテキストプロトコル（MCP）サーバーです。

🚀 クイックスタート

このプロジェクトは、Anthropicのモデルコンテキストプロトコル（MCP）を通じて、ClaudeのようなAIアシスタントとWordwareの専門的なプロキシ機能をつなぐ架け橋を築きます。この統合により、設定に基づいてWordware APIからツールを動的に読み込み、Claudeが専門的なWordwareプロセスにアクセスできるようになります。

✨ 主な機能

• 🔄 動的ツール読み込み - 設定に応じてWordware APIから自動的にツールを読み込みます。
• 🧠 スマートモード検出 - 異なるツールの入力モードを自動的に検出し、適応します。
• 🔍 高度なパラメータ処理 - さまざまな入力形式（JSON、ネスト構造、文字列）を処理します。
• ⚙️ 強力なエラー処理 - 包括的なエラーログ記録とイベントループ管理を行います。
• 🔑 シンプルな認証 - 設定を通じて簡単にWordwareアカウントを接続できます。

📦 インストール

前提条件

• Python 3.8+
• Wordware API の認証情報
• Claude Desktop またはその他の MCP 互換クライアント

インストール手順

# リポジトリをクローンする
git clone https://github.com/yourusername/wordware-mcp.git
cd wordware-mcp

# 仮想環境を作成する
python -m venv venv
source venv/bin/activate  # Windowsの場合は：venv\Scripts\activate

# 依存関係をインストールする
pip install -r requirements.txt

# 環境変数を設定する
cp .env.example .env
# .envファイルをWordware APIの認証情報で編集する

📚 ドキュメント

設定

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 環境変数を使用します。

サーバーの起動

# デフォルト設定で起動
python server.py

# デバッグログで起動
python server.py --debug

# 特定のポートでSSEトランスポートで起動
python server.py --transport sse --host 127.0.0.1 --port 8000

# またはClaude Desktopにインストール
mcp install python server.py --name "Wordware ツール"

動作原理

Wordware MCPサーバーは以下の手順で動作します。

1. ツール設定の読み込み - 設定ファイルからツールIDのリストを読み込みます。
2. 動的ツール登録 - 各ツールIDに対して：
   • Wordware APIからメタデータを取得します。
   • 入力モードの要件を検出します。
   • 対応するMCPツール関数を作成します。
   • ツールをMCPサーバーに登録します。
3. リクエスト処理 - ツールが呼び出されたとき：
   • 入力パラメータのさまざまな形式（JSONオブジェクト、文字列、ネスト構造）を処理します。
   • ツールの要件に合わせてパラメータの形式を調整します。
   • 正しくフォーマットされたリクエストをWordware APIに送信します。
4. レスポンス処理 - Wordware APIのレスポンスを処理します：
   • Server-Sentイベント（SSE）ストリームを解析します。
   • すべての出力値を収集します。
   • Claudeに対するレスポンスをユーザーフレンドリーな形式でフォーマットします。

高度な機能

スマートパラメータ処理

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

• 直接パラメータ：{"Full Name": "John Doe", "Company": "Tech Corp"}
• JSON形式の文字列："{\"Full Name\": \"John Doe\", \"Company\": \"Tech Corp\"}"
• ネスト構造：[ {"name": "John Doe"}, {"company": "Tech Corp"} ]

ツール登録

設定ファイルで登録するツールIDを指定すると、サーバーが自動的にこれらのツールを読み込み、登録します。

実行時の例

# サンプル設定ファイル tools_config.json
{
  "tools": [
    {
      "id": "wordware_create_document"
    },
    {
      "id": "wordware_analyze_data"
    }
  ]
}

# サーバーを起動する
python server.py

# これでツールが登録され、Claudeで使用できるようになりました

貢献

貢献は大歓迎です！気軽にPull Requestを送信してください。

ライセンス

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

謝辞

• Anthropic - モデルコンテキストプロトコルの提供
• Wordware - プロキシプラットフォームの提供
• MCP Python SDK - プロトコルの実装