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

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

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


为什么 UTCP 会火?

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

核心设计理念:

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

Python UTCP SDK:结构与核心

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

核心分为两部分:

1. utcp 核心模块
  • 数据模型 :使用 Pydantic 构建 Tool、CallTemplate、UtcpManual、Auth 等;
  • 可插拔接口 :CommunicationProtocol、ConcurrentToolRepository、ToolSearchStrategy、VariableSubstitutor、ToolPostProcessor;
  • 默认实现组件 :如 UtcpClient、内存版本的 InMemToolRepository,以及关键词匹配策略 TagAndDescriptionWordMatchStrategy (GitHub3)。
2. 插件式协议支持

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

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

上手示例: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 配置文件初始化客户端,这些逻辑已现代化清晰划分 (GitHub3)。


为什么推荐这套方案?

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

总结

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

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


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

相关推荐
Highcharts.js2 小时前
Highcharts漏斗图表使用配置指南
java·开发语言·javascript·信息可视化·highcharts·漏斗图
wuyk5557 小时前
Python办公自动化-第01讲-环境搭建与自动化认知
python·自动化·pyqt
高洁018 小时前
数字孪生与计算机视觉:让机器看懂现场
人工智能·python·机器学习·transformer·迁移学习
ComPDFKit8 小时前
RAG 回答只显示 PDF 文件名?用 Python 保留引用页码
开发语言·python·pdf·rag
FRing038 小时前
vue3干货总结2(vue3生命周期、父子通信、模版引用、provide和inject)
开发语言·前端·vue.js·vue3
yz_aiks9 小时前
Termux 使用教程:把安卓手机变成随身 Linux(装 Python、SSH 远程、跑自动化脚本)
android·linux·python·智能手机·ssh·termux
琳少_10 小时前
java程序开发笔记
java·开发语言·数据库·笔记
七夜zippoe11 小时前
Agent 告警设计:分级告警、智能降噪与值班排班
开发语言·ai·agent·告警·智能降噪·值班排班
2601_9679801111 小时前
Flask Web 应用
python·flask·web开发·环境变量·虚拟环境
aifannihao12 小时前
ß 大写变 SS:用 Python 算清 Ruby2Shell 的缓冲区账本
python·安全·标准库·缓冲区溢出·字符串编码