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

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

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


为什么 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 构建 ToolCallTemplateUtcpManualAuth 等;
  • 可插拔接口CommunicationProtocolConcurrentToolRepositoryToolSearchStrategyVariableSubstitutorToolPostProcessor
  • 默认实现组件 :如 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 插件:

bash 复制代码
pip install utcp utcp-http

快速示例(简化流程)

python 复制代码
import asyncio
from utcp.utcp_client import UtcpClient
from utcp_http.http_call_template import HttpCallTemplate
from utcp.data.utcp_client_config import UtcpClientConfig

async 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())

你也可以用 JSON 配置文件初始化客户端,这些逻辑已现代化清晰划分 ([GitHub][3])。


为什么推荐这套方案?

  • 极强的一致性:描述逻辑清晰,把协议和工具定义分开,结构理想;
  • 统一调用方式:客户端只关注调用"手册",不用写一堆冗余代码;
  • 高扩展性:插件型协议支持,未来要加 WebSocket、GraphQL、CLI都轻松插入;
  • 开源社区活跃:Python SDK 已有人提议新增 gRPC、GraphQL、Socket 等支持,说明正在迅速完善 ([GitHub][4])。

总结

UTCP 是 AI 工具调用的轻量革命:不再写桥、不再部署代理------直接通过 JSON 手册告诉 AI:如何调用、在哪调用。Python SDK 实现优雅,社区生态逐步完善,对 AI Agent 体系构建者来说值得关注。

喜欢就奖励一个"👍"和"在看"呗~


喜欢就奖励一个"👍"和"在看"呗~

相关推荐
java1234_小锋10 分钟前
[免费]基于Python的Flask+Vue进销存仓库管理系统【论文+源码+SQL脚本】
后端·python·flask
-雷阵雨-11 分钟前
数据结构——LinkedList和链表
java·开发语言·数据结构·链表·intellij-idea
大飞pkz3 小时前
【设计模式】责任链模式
开发语言·设计模式·c#·责任链模式
AI视觉网奇4 小时前
rknn yolo11 推理
前端·人工智能·python
gplitems1234 小时前
Gunslinger – Gun Store & Hunting WordPress Theme: A Responsible
开发语言·前端·javascript
AI数据皮皮侠4 小时前
中国各省森林覆盖率等数据(2000-2023年)
大数据·人工智能·python·深度学习·机器学习
大飞pkz5 小时前
【设计模式】六大基本原则
开发语言·设计模式·c#·六大原则
iCxhust5 小时前
Intel8259汇编串口接收转C语言
c语言·开发语言·汇编
西柚小萌新6 小时前
【深入浅出PyTorch】--3.1.PyTorch组成模块1
人工智能·pytorch·python
掘根6 小时前
【Qt】布局管理器
开发语言·qt