ワードウェア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

license - not found

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

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

Related MCP Servers

ServiceNow MCP Server
michaelbuckner
-
security
A
license
-
quality
A Model Context Protocol server enabling AI agents to access and manipulate ServiceNow data through natural language interactions, allowing users to search for records, update them, and manage scripts.
Last updated -
9
Python
MIT License
Notion MCP Server
Sjotie
A
security
F
license
A
quality
A Model Context Protocol server that connects Claude and other AI assistants to your Notion workspace, allowing AIs to interact with databases, pages, and blocks.
Last updated -
12
0
10
JavaScript
Zulip MCP Server
Monadical-SAS
-
security
A
license
-
quality
A Model Context Protocol server that enables AI assistants like Claude to interact with Zulip workspaces, supporting capabilities such as posting messages, listing channels, sending direct messages, and accessing conversation history.
Last updated -
JavaScript
Apache 2.0
Notion MCP Server
emmanuelsystems
A
security
F
license
A
quality
A Model Context Protocol server that connects AI assistants like Claude to Notion workspaces, enabling them to view, search, create, and update Notion databases, pages, and content blocks.
Last updated -
12
194
JavaScript

View all related MCP servers

Wordware MCP