Universal Tool Calling Protocol (utcp Client)

UTCP-MCP ブリッジ

これが最後に必要となる MCP サーバーです。

Universal Tool Calling Protocol（UTCP）のすべての機能を MCP エコシステムにもたらす、汎用のオールインワン MCP サーバーです。

🚀 クイックスタート

この設定を MCP クライアント（Claude Desktop など）に追加してください。

{
  "mcpServers": {
    "utcp": {
      "command": "npx",
      "args": ["@utcp/mcp-bridge"],
      "env": {
        "UTCP_CONFIG_FILE": "/path/to/your/.utcp_config.json"
      }
    }
  }
}

これだけです！ インストールは不要です。ブリッジが自動的に次の処理を行います。

• npx 経由で最新バージョンをダウンロードして実行します
• 指定されたパスから UTCP 設定を読み込みます
• すべての UTCP マニュアルを MCP ツールとして登録します
• ツールエコシステムを管理するための統一インターフェースを提供します

🔧 設定

ツールとサービスを設定するために、.utcp_config.json ファイルを作成します。

{
    "load_variables_from": [
      {
        "variable_loader_type": "dotenv",
        "env_file_path": ".env"
      }
    ],
    "manual_call_templates": [
      {
          "name": "openlibrary",
          "call_template_type": "http",
          "http_method": "GET", 
          "url": "https://openlibrary.org/static/openapi.json",
          "content_type": "application/json"
      }
    ],
    "post_processing": [
      {
          "tool_post_processor_type": "filter_dict",
          "only_include_keys": ["name", "description"],
          "only_include_tools": ["openlibrary.*"]
      }
    ],
    "tool_repository": {
      "tool_repository_type": "in_memory"
    },
    "tool_search_strategy": {
      "tool_search_strategy_type": "tag_and_description_word_match"
    }
}

Claude Code（CLI）

Claude Code（CLI／IDE 拡張機能）では、ブリッジをユーザースコープの MCP サーバーとして登録します。

claude mcp add-json --scope user utcp '{"type":"stdio","command":"npx","args":["@utcp/mcp-bridge"],"env":{"UTCP_CONFIG_FILE":"/absolute/path/to/.utcp_config.json"}}'

その後、Claude Code を再起動します。claude mcp list で確認できます。削除するには、claude mcp remove utcp --scope user を実行します。

🧪 ブリッジを使ったローカル開発

@utcp/sdk やその他の typescript-utcp パッケージを開発し、Claude Code 経由で動作を確認する場合は、開発用スクリプトを使用します。

cd utcp-mcp
npm install
npm run dev:register     # builds typescript-utcp packages, overlays each into the bridge's node_modules, builds the bridge, and registers it as 'utcp-dev' in Claude Code
# restart Claude Code

# After every edit:
npm run dev:register     # rebuilds, re-registers; restart Claude Code

# When done:
npm run dev:unregister   # removes the MCP entry and restores registry node_modules

どちらのスクリプトも冪等で、package.json を変更することはありません。このオーバーレイ方式では npm link を使いません。最新の npm では unlink が uninstall --save のエイリアスになっており、依存関係が気づかないうちに削除されるためです。

スクリプトは、typescript-utcp のチェックアウトがこのリポジトリの隣（../typescript-utcp）にあることを想定しています。異なる場所にある場合は、フラグで指定してください。

• --lib-dir <path> — 別の typescript-utcp チェックアウトを指定します。または none を指定すると、オーバーレイの手順を完全に省略できます（ブリッジだけを編集する場合に便利です）。
• --name <mcp-name>（デフォルトは utcp-dev）— 公開済みのブリッジと並行して開発用ブリッジを使う場合に便利です。
• --config <path>（デフォルトは ./.utcp_config.json）— 別の UTCP 設定を指定します。

🛠️ 利用可能な MCP ツール

ブリッジでは、UTCP エコシステムを管理するために以下の MCP ツールを利用できます。

• register_manual - 新しい UTCP マニュアル／API を登録します
• deregister_manual - 登録済みのマニュアルを削除します
• call_tool - 登録済みの任意の UTCP ツールを実行します
• search_tools - 説明からツールを検索します
• list_tools - 登録済みのすべてのツール名を一覧表示します
• get_required_keys_for_tool - 必要な環境変数を取得します
• tool_info - ツールの詳細情報とスキーマを取得します

📁 UTCP とは？

Universal Tool Calling Protocol（UTCP）を使うと、次のことができます。

• あらゆる API に接続 — HTTP、OpenAPI 仕様、カスタム形式を利用できます
• コマンドラインツールを使用 — 引数を自動的に解析します
• テキストやファイルを処理 — 組み込みのユーティリティを利用できます
• 複数のツールを連携・組み合わせ — シームレスに実行できます

この MCP ブリッジを使うと、すべての UTCP ツールを Claude Desktop やその他の MCP クライアントから利用できます。

🌟 特長

• ✅ インストール不要 — npx 経由で動作します
• ✅ 幅広い互換性 — あらゆる MCP クライアントで動作します
• ✅ 動的な設定 — 再起動せずにツールを更新できます
• ✅ 環境の分離 — プロジェクトごとに独自の設定を使用できます
• ✅ 包括的なツール管理 — ツールの登録、検索、呼び出し、確認ができます
• ✅ Web インターフェースを利用可能 — web_ui_utcp_mcp_bridge/ を参照してください

🐍 Python 版

Python をお使いの場合は、python_mcp_bridge/ のスタンドアロン Python 実装を参照してください。

🌐 Web インターフェース

Web UI を使った高度な管理については、web_ui_utcp_mcp_bridge/ をご覧ください。

---