python-utcp

This MCP server is built as part of the Universal Tool Calling Protocol (UTCP) Python implementation and provides an MCP-compliant interface for managing and invoking tools via the UTCP framework. It leverages the UTCP core library and the MCP plugin to expose a standardized protocol for discovering, calling, and composing tool calls across protocols. The server enables clients to push or query for available tools, submit CallTemplates, and perform calls in a consistent, pluggable manner. Tools are accessed through namespaced identifiers and can be invoked with structured payloads, allowing seamless integration with HTTP, CLI, text, and other protocol plugins supported by UTCP. Typical usage involves starting the MCP server, then connecting a client (UTCP client) to register or discover MCP-capable tools, and finally issuing calls to those tools using the UTCP call templates and the MCP protocol semantics.

{"Prerequisites:","- Python 3.8+ (recommended: Python 3.9+)","- pip (Python package installer)","","Install the UTCP core library and the MCP protocol plugin (from PyPI):","bash","pip install utcp utcp-mcp","","","Optionally install additional UTCP protocol plugins you plan to use (e.g., HTTP, CLI, TEXT):","bash","pip install utcp-http utcp-cli utcp-text","","","If you want to run from source, clone the repository and install in editable mode:","bash","git clone https://github.com/universal-tool-calling-protocol/python-utcp.git","cd python-utcp","pip install -e \"core[dev]\"","pip install -e plugins/communication_protocols/mcp","","","Run the MCP server (example using the documented mcp_server entry point):","bash","python -m utcp.mcp_server","","","Note: The exact server entry point may vary depending on your environment and how you spin up the MCP server; the example above follows the common pattern of invoking a Python module as a script."}

{"Environment variables and configuration:","- UTCP_CONFIG_PATH (optional): Path to a JSON configuration file for the MCP server. If omitted, the server may use internal defaults or environment-based configuration.","- Other UTCP environment variables may be exposed by the core library or plugins (e.g., for logging, network bindings, or authentication).","","Common issues and tips:","- Ensure your Python version matches the minimum requirement for UTCP and the MCP plugin.","- If you modify configuration, restart the MCP server to apply changes.","- When integrating with other protocol plugins (HTTP, CLI, TEXT), ensure the call templates align with the MCP tool naming and scoping conventions described in the UTCP migration guide.","- Review plugin README files under plugins/communication_protocols/mcp/ for protocol-specific usage details and examples."}