utcp-mcp

# UTCP-MCP Bridge **The last MCP server you'll ever need.** A universal, all-in-one MCP server that brings the full power of the Universal Tool Calling Protocol (UTCP) to the MCP ecosystem. ## 🚀 Quick Start Add this configuration to your MCP client (Claude Desktop, etc.): ```json { "mcpServers": { "utcp": { "command": "npx", "args": ["@utcp/mcp-bridge"], "env": { "UTCP_CONFIG_FILE": "/path/to/your/.utcp_config.json" } } } } ``` **That's it!** No installation required. The bridge will automatically: - Download and run the latest version via npx - Load your UTCP configuration from the specified path - Register all your UTCP manuals as MCP tools - Provide a unified interface to manage your tool ecosystem ## 🔧 Configuration Create a `.utcp_config.json` file to configure your tools and services: ```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" } } ``` ## 🛠️ Available MCP Tools The bridge exposes these MCP tools for managing your UTCP ecosystem: - **`register_manual`** - Register new UTCP manuals/APIs - **`deregister_manual`** - Remove registered manuals - **`call_tool`** - Execute any registered UTCP tool - **`search_tools`** - Find tools by description - **`list_tools`** - List all registered tool names - **`get_required_keys_for_tool`** - Get required environment variables - **`tool_info`** - Get complete tool information and schema ## 📁 What is UTCP? The Universal Tool Calling Protocol (UTCP) allows you to: - **Connect to any API** via HTTP, OpenAPI specs, or custom formats - **Use command-line tools** with automatic argument parsing - **Process text and files** with built-in utilities - **Chain and combine** multiple tools seamlessly With this MCP bridge, all your UTCP tools become available in Claude Desktop and other MCP clients. ## 🌟 Features - ✅ **Zero installation** - Works via npx - ✅ **Universal compatibility** - Works with any MCP client - ✅ **Dynamic configuration** - Update tools without restarting - ✅ **Environment isolation** - Each project can have its own config - ✅ **Comprehensive tool management** - Register, search, call, and inspect tools - ✅ **Web interface available** - See [web_ui_utcp_mcp_bridge/](web_ui_utcp_mcp_bridge/) ## 🐍 Python Version For Python users, see the standalone Python implementation in [`python_mcp_bridge/`](python_mcp_bridge/) ## 🌐 Web Interface For advanced management with a web UI, check out [`web_ui_utcp_mcp_bridge/`](web_ui_utcp_mcp_bridge/) --- <img width="2263" height="976" alt="UTCP MCP Bridge Interface" src="https://github.com/user-attachments/assets/a6759512-1c0d-4265-9518-64916fbe1428" />