用 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 体系构建者来说值得关注。

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


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

相关推荐
1379号监听员_1 小时前
嵌入式软件架构--按键消息队列3(测试)
开发语言·stm32·单片机·嵌入式硬件·架构
阿登林2 小时前
C# iText7与iTextSharp导出PDF对比
开发语言·pdf·c#
小白银子2 小时前
零基础从头教学Linux(Day 54)
linux·windows·python
不爱搬砖的码农2 小时前
宝塔面板部署Django:使用Unix Socket套接字通信的完整教程(附核心配置与问题排查)
python·django·unix
qq_433554542 小时前
C++ 双向循环链表
开发语言·c++·链表
滑水滑成滑头2 小时前
**发散创新:探索零信任网络下的安全编程实践**随着信息技术的飞速发展,网络安全问题日益凸显。传统的网络安全防护方式已难以
java·网络·python·安全·web安全
一只侯子2 小时前
Tuning——CC调试(适用高通)
开发语言·图像处理·笔记·学习·算法
丁浩6662 小时前
Python机器学习---1.数据类型和算法:线性回归
开发语言·python·机器学习·线性回归
それども2 小时前
HTTP 三次握手最终状态变更的时机
网络·网络协议·http
那年窗外下的雪.2 小时前
鸿蒙ArkUI布局与样式进阶(十二)——自定义TabBar + class类机制全解析(含手机商城底部导航案例)
开发语言·前端·javascript·华为·智能手机·harmonyos·arkui