Utcp MCP

🚀 UTCP-MCP Bridge

The ultimate MCP server that meets all your needs.

UTCP-MCP Bridge is a comprehensive and all-in-one MCP server that integrates the full capabilities of the Universal Tool Calling Protocol (UTCP) into the MCP ecosystem. With this project, you can:

• Utilize UTCP as a proxy: Instantly expose all tools registered via UTCP as MCP-compatible tools, making them accessible to any MCP client.
• Directly use the UTCP client: Register and deregister providers, search for and call tools, unlocking the core functions of the UTCP client from a single interface.
• Web interface: Effortlessly manage your tools and providers through a user-friendly web UI. Register and deregister providers, enable and disable tools, and perform many other operations with just a few clicks. More features are on the way!

With UTCP-MCP Bridge, you only need to install one MCP server to access, manage, and expand your tool ecosystem, regardless of your usage preferences.

🚀 Quick Start

You can run the UTCP-MCP Bridge in three ways: using Docker, a local bash script, or a PowerShell script.

🐳 Run with Docker

Ensure that Docker and Docker Compose are installed.

docker-compose up --build

💻 Run with Bash Script

Make sure you have Python 3 installed.

./run.sh

🪟 Run with PowerShell Script

Ensure Python 3 is installed.

./run.ps1

Running the application will:

• Set up a Python virtual environment with all dependencies or build the Docker image.
• Start the MCP servers and the WEB server.
• Expose the following ports:
  • 8776 (UTCP Client MCP)
  • 8777 (UTCP Proxy MCP)
  • 8778 (FastAPI web server)

🔗 Connect with your MCP Client

To connect your MCP client to the UTCP-MCP Bridge, add the following entries to your client's mcp.json (or equivalent configuration file):

Cursor Example

{
  "mcpServers": {
    // any other mcp servers
    "utcp-proxy-mcp-local": {
      "url": "http://localhost:8777/utcp-proxy"
    },
    "utcp-client-mcp-local": {
      "url": "http://localhost:8776/utcp-client"
    }
  }
}

VS Code Example

{
  "servers": {
    // any other mcp servers
    "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 connects to the UTCP Proxy MCP server (port 8777).
• utcp-client-mcp-local connects to the UTCP Client MCP server (port 8776).

Adjust the URLs if you are running the server on a different host or port.

🌐 UI Interface

The web interface for viewing and managing providers and tools can be accessed in any browser at http://localhost:8778/.

⚙️ Configuration

• Provider and tool definitions are loaded from the data/ directory (e.g., data/providers.json).
• Environment variables can be set in Docker Compose or your shell to customize ports and paths.

📚 Documentation

API Endpoints

• / – Web UI
• /health – Health check and status
• /tools – List available tools
• /providers – List available providers

📦 Installation

Dependencies

• utcp
• fastmcp
• fastapi
• python-dotenv

All dependencies are automatically installed by the Docker image or the bash script.