Utcp MCP

🚀 UTCP-MCP Bridge

これがあれば、あなたが必要とする最後のMCPサーバーです。

UTCP-MCP Bridgeは、Universal Tool Calling Protocol (UTCP) の全機能をMCPエコシステムにもたらす、ユニバーサルな統合型MCPサーバーです。このプロジェクトを使用することで、以下のことが可能です。

• UTCPをプロキシとして使用する：UTCPを介して登録されたすべてのツールを即座にMCP互換ツールとして公開し、任意のMCPクライアントから利用可能にします。
• UTCPクライアントを直接使用する：プロバイダーの登録と登録解除、ツールの検索と呼び出しを行い、UTCPクライアントの主要機能を一箇所から利用できます。
• Webインターフェイス：使いやすいWeb UIを通じて、ツールとプロバイダーを簡単に管理できます。プロバイダーの登録と登録解除、ツールの有効化と無効化など、すべて数クリックで行えます。今後もさらなる機能が追加されます！

UTCP-MCP Bridgeを使用することで、どのように利用したい場合でも、たった1つのMCPサーバーをインストールするだけで、ツールエコシステムにアクセス、管理、拡張することができます。

🚀 クイックスタート

UTCP-MCP Bridgeは、Dockerまたはローカルのbashスクリプトを使用して実行することができます。

1.1 Dockerで実行する

DockerとDocker Composeがインストールされていることを確認してください。

docker-compose up --build

1.2 Bashスクリプトで実行する

Python 3がインストールされていることを確認してください。

./run.sh

1.3 PowerShellスクリプトで実行する

Python 3がインストールされていることを確認してください。

./run.ps1

これにより、以下のことが行われます。

• すべての依存関係を含むPython仮想環境をセットアップするか、Dockerイメージをビルドします。
• MCPサーバーとWEBサーバーを起動します。
• 以下のポートを公開します。
  • 8776 (UTCP Client MCP)
  • 8777 (UTCP Proxy MCP)
  • 8778 (FastAPIウェブサーバー)

2 任意のMCPクライアントで接続する

MCPクライアントをUTCP-MCP Bridgeに接続するには、クライアントの mcp.json（または同等の設定ファイル）に以下のエントリを追加してください。

Cursorの例：

{
  "mcpServers": {
    // 他のMCPサーバー
    "utcp-proxy-mcp-local": {
      "url": "http://localhost:8777/utcp-proxy"
    },
    "utcp-client-mcp-local": {
      "url": "http://localhost:8776/utcp-client"
    }
  }
}

VS Codeの例：

{
  "servers": {
    // 他のMCPサーバー
    "utcp-proxy-mcp-local": {
      "url": "http://localhost:8777/utcp-proxy",
      "type": "http"
    },
    "utcp-client-mcp-local": {
      "url": "http://localhost:8776/utcp-client",
      "type": "http"
    }
  },
  "inputs": []
}

• utcp-proxy-mcp-local はUTCP Proxy MCPサーバー（ポート8777）に接続します。
• utcp-client-mcp-local はUTCP Client MCPサーバー（ポート8776）に接続します。

サーバーを別のホストまたはポートで実行している場合は、URLを調整してください。

3 UIインターフェイス

プロバイダーとツールを表示および管理するためのWebインターフェイスは、任意のブラウザで http://localhost:8778/ からアクセスできます。

📚 ドキュメント

• プロバイダーとツールの定義は、data/ ディレクトリ（例：data/providers.json）から読み込まれます。
• 環境変数は、Docker Composeまたはシェルで設定することができ、ポートやパスをカスタマイズできます。

📄 APIエンドポイント

• / – Web UI
• /health – ヘルスチェックとステータス
• /tools – 利用可能なツールの一覧
• /providers – 利用可能なプロバイダーの一覧

🔧 依存関係

• utcp
• fastmcp
• fastapi
• python-dotenv

すべての依存関係は、Dockerイメージまたはbashスクリプトによって自動的にインストールされます。