当前位置：首页 > news >正文

用 Python UTCP 直调 HTTP、CLI、MCP……

news 2025/9/11 12:42:40

大家好，这里是架构资源栈！点击上方关注，添加“星标”，一起学习大厂前沿架构！

关注、发送C1即可获取JetBrains全家桶激活工具和码！

utcp.io

为什么 UTCP 会火？

近年来，AI 需要调用外部工具越来越普遍。传统的 MCP（Model Context Protocol）方式往往需搭建中间层代理，既臃肿又拖延。UTCP（Universal Tool Calling Protocol）提出了更优雅的做法：AI 通过标准描述“手册”直连工具本体，不绕道中间代理，延迟低、结构清晰 ([GitHub][1], [UTCP][2])。

核心设计理念：

不改活体接口：无需重写现有工具；
无需代理：AI 能直接对接工具本身的 API 或命令行；
标准手册：工具如何被调用通过 JSON 描述清晰可查；
高效灵活：兼容各种协议（HTTP、CLI、WebSocket 等）。

Python UTCP SDK：结构与核心

这是官方 Python 实现，GitHub 上有近 440 颗⭐，采用 MPL-2.0 开源许可 ([GitHub][1])。其架构简洁但功能强大：

核心分为两部分：

1. `utcp` 核心模块

数据模型：使用 Pydantic 构建 Tool、CallTemplate、UtcpManual、Auth 等；
可插拔接口：CommunicationProtocol、ConcurrentToolRepository、ToolSearchStrategy、VariableSubstitutor、ToolPostProcessor；
默认实现组件：如 UtcpClient、内存版本的 InMemToolRepository，以及关键词匹配策略 TagAndDescriptionWordMatchStrategy ([GitHub][3])。

2. 插件式协议支持

核心只保留协议无关的基础功能，协议实现用插件方式开发：

utcp-http 支持 HTTP、SSE、可流式 HTTP 等；
utcp-cli 支持本地命令行工具调用；
utcp-mcp 支持与 Model Context Protocol（MCP）的兼容；
utcp-text 能读取文本文件；
utcp-socket（TCP/UDP）、utcp-gql（GraphQL）目前仍在进行中 ([GitHub][3])。

上手示例：Python 端如何使用？

安装核心 + HTTP 插件：

pip install utcp utcp-http

快速示例（简化流程）

import asyncio
from utcp.utcp_client import UtcpClient
from utcp_http.http_call_template import HttpCallTemplate
from utcp.data.utcp_client_config import UtcpClientConfigasync def main():config = UtcpClientConfig(variables={"openlibrary_URL": "..."},manual_call_templates=[HttpCallTemplate(name="openlibrary",call_template_type="http",http_method="GET",url="${openlibrary_URL}",content_type="application/json")])client = await UtcpClient.create(config=config)result = await client.call_tool(tool_name="openlibrary.read_search_authors_json_search_authors_json_get",tool_args={"q": "J. K. Rowling"})print(result)asyncio.run(main())