Zig Utcp

MCP运维云端

提供方 bkataru

运维云端 未标注 无需鉴权 社区 / 第三方

zig-utcp是一个用于Zig语言的通用工具调用协议(UTCP)实现,支持多种传输协议和认证方法,适用于LLM工具集成。

一句话选型结论

按资料字段整理

Zig Utcp 属于运维云端类 MCP 服务器,传输方式未标注,无需鉴权,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类运维云端 传输方式未标注 鉴权无需鉴权 部署方式未标注
GitHub 星标 2 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

运维云端
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

适用场景

Zig本地部署LLM工具集成多协议支持Zig开发API调用工具管理

安装与配置

未标注 无需鉴权
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
云资源查询

查实例、存储、账单等云上资源状态。

部署与发布

把部署、重启、回滚这类操作接进对话。

监控与告警

拉取监控指标,异常时让模型帮你判断。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在运维云端场景里让模型直接调用外部能力的人。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Zig Utcp当前 未标注 未标注 未标注 无 2026-05-17
lobehub 未标注 stdio · 本地进程 本地部署 有 2026-04-11
TrendRadar 未标注 stdio · 本地进程 本地部署 有 2026-04-13
Ui Tars Desktop 8a825770 未标注 stdio · 本地进程 本地部署 有 2026-05-17
ruflo 未标注 stdio · 本地进程 本地部署 有 2026-04-13
FastGPT 未标注 stdio · 本地进程 本地部署 有 2026-04-11

服务器档案

运维云端
字段来自项目仓库与公开索引,中文说明由本站标注
提供方bkataru上游标注的维护方 bkataru
分类运维云端本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

9.3 KB
来自项目仓库与上游目录的原文,未做删改

zig utcp

通用工具调用协议(UTCP) Zig 0.15.2的实现+

LLM工具集成的供应商无关标准,支持HTTP、CLI、MCP、SSE、WebSocket等。

特性

  • 零依赖 -仅限纯Zig标准库
  • 显式错误处理 -Zig错误接头(无例外)
  • Comptime多态性 -通过以下方式进行通用传输 comptime
  • 9运输类型 -HTTP、CLI、MCP、SSE、WebSocket、文本、UDP、GraphQL、gRPC
  • 4认证方法 -API密钥,基本,承载,OAuth2(带令牌刷新)
  • 2台工具装载机 -JSON、OpenAPI
  • 流媒体 -增量响应处理
  • 后置处理器 -响应转换和验证
  • 内存效率高 -请求/响应生命周期的竞技场分配器

v0.2.0中的新功能

  • CLI工具 - utcp 测试工具定义命令
  • 中间件 -用于日志记录、度量、身份验证注入的请求/响应拦截器
  • 断路器 -通过自动恢复防止级联故障
  • 速率限制 -令牌桶、滑动窗口和固定窗口算法
  • 响应缓存 -基于TTL的缓存,具有可配置的最大条目
  • 批量请求 -并行执行多个工具调用
  • 调试模式 -详细记录请求/响应时间
  • 模式验证 -根据JSON模式验证工具输入
  • 模拟运输 -无需网络调用的单元测试
  • 重试策略 -瞬态故障时具有抖动的指数回退
  • 基准测试 -性能回归测试 zig build bench
  • API文件 -生成文档 zig build docs

需求

  • Zig 0.15.2或更高版本

安装

选项1:使用 zig fetch (推荐)```bash

zig fetch --save git+https://github.com/bkataru/zig-utcp.git


要获取特定版本,请执行以下操作:```bash
zig fetch --save git+https://github.com/bkataru/zig-utcp.git#v0.1.0

选项2:手动配置

添加到您的 build.zig.zon:``zig .dependencies = .{ .utcp = .{ .url = "git+https://github.com/bkataru/zig-utcp.git", .hash = "...", // Runzig build` to get the correct hash
},
},


### 选项3:本地路径依赖```zig
.dependencies = .{
.utcp = .{
.path = "../zig-utcp",
},
},

配置 `build.zig````zig

const std = @import("std");

pub fn build(b: *std.Build) void {
const target = b.standardTargetOptions(.{});
const optimize = b.standardOptimizeOption(.{});

// Fetch the utcp dependency
const utcp_dep = b.dependency("utcp", .{
.target = target,
.optimize = optimize,
});

// Get the module from the dependency
const utcp_mod = utcp_dep.module("utcp");

// Create your executable
const exe = b.addExecutable(.{
.name = "my_tool_client",
.root_module = b.createModule(.{
.root_source_file = b.path("src/main.zig"),
.target = target,
.optimize = optimize,
}),
});

// Add the utcp import to your executable
exe.root_module.addImport("utcp", utcp_mod);

b.installArtifact(exe);
}


### 从源头构建```bash
# Clone the repository
git clone https://github.com/bkataru/zig-utcp.git
cd zig-utcp

# Build the library
zig build

# Run tests
zig build test

# Build examples
zig build examples

# Build release version
zig build -Doptimize=ReleaseFast

快速开始```zig

const std = @import("std");
const utcp = @import("utcp");

pub fn main() !void {
var gpa = std.heap.GeneralPurposeAllocator(.{}){};
defer _ = gpa.deinit();
const allocator = gpa.allocator();

// Create HTTP transport
var transport = utcp.HttpTransport.init(allocator);
defer transport.deinit();
try transport.loadEnv();

// Define a tool
const weather_tool = utcp.Tool{
.id = "weather_api",
.name = "Get Weather",
.description = "Fetch current weather for a city",
.call_template = .{
.http = .{
.method = "GET",
.url = "https://wttr.in/{city}?format=j1",
.timeout_ms = 30000,
},
},
};

// Prepare request
var inputs_obj = std.json.ObjectMap.init(allocator);
defer inputs_obj.deinit();
try inputs_obj.put("city", .{ .string = "London" });

const request = utcp.ToolCallRequest{
.tool_id = "weather_api",
.inputs = .{ .object = inputs_obj },
};

// Call the tool
const response = try transport.call(weather_tool, request, null);
std.debug.print("Response: {any}\n", .{response.output});
}


## 例子

运行附带的示例:```bash
# HTTP client (calls wttr.in weather API)
zig build run-http

# CLI client
zig build run-cli

# MCP client
zig build run-mcp

# Streaming example
zig build run-streaming

# Post-processor example
zig build run-postprocessor

# OAuth2 example
zig build run-oauth2

# UTCP CLI tool
zig build run-utcp -- help
zig build run-utcp -- info
zig build run-utcp -- load tools.json

看 examples/ 查看完整的工作示例。

API 参考

核心类型

类型 描述
Tool 带有id、名称、描述、call_template的工具定义
ToolCallRequest 带有tool_id和输入的请求
ToolCallResponse 带有输出和可选错误的响应
Provider 具有身份验证配置的提供程序
CallTemplate 特定于传输的呼叫配置

运输

运输 说明
HttpTransport 支持OAuth2的HTTP/HTTPS
CliTransport CLI子流程执行
McpTransport MCP JSON-RPC(标准输入+HTTP模式)
SseTransport 服务器发送的事件
WebSocketTransport WebSocket连接
TextTransport 文本输出(plain/json/xml)
UdpTransport UDP数据报
GraphqlTransport 基于HTTP的GraphQL
GrpcTransport gRPC Web兼容

装载机

加载器 说明
loadToolsFromJson 从JSON加载工具
convertFromString 将OpenAPI规范转换为UTCP工具

流媒体```zig

const stream = utcp.fromBytes(allocator, data);
defer stream.deinit();

while (stream.next()) |chunk| {
// Process chunk
if (chunk.is_final) break;
}


### 后置处理器```zig
var chain = utcp.PostProcessorChain.init(allocator);
defer chain.deinit();

try chain.addFn("trim", utcp.trimProcessor);
try chain.addFn("log", utcp.logProcessor);
try chain.process(&response);

中间件```zig

var chain = utcp.MiddlewareChain.init(allocator);
defer chain.deinit();

// Add logging middleware
try chain.add(.{
.name = "logger",
.on_request = logRequest,
.on_response = logResponse,
});

// Process request through middleware
try chain.processRequest(&context);
const response = try transport.call(tool, request, provider);
try chain.processResponse(&context, &response);


### 断路器```zig
var breaker = utcp.CircuitBreaker.init(.{
.failure_threshold = 5,
.reset_timeout_ms = 30000,
});

if (breaker.canExecute()) {
const result = transport.call(tool, request, provider);
if (result) |resp| {
breaker.recordSuccess();
} else |_| {
breaker.recordFailure();
}
}

速率限制```zig

var limiter = utcp.TokenBucket.init(.{
.burst_size = 100,
.refill_rate = 10.0, // tokens per second
});

if (limiter.tryAcquire()) {
// Proceed with request
} else {
// Rate limited
}


### 响应缓存```zig
var cache_inst = utcp.ResponseCache.init(allocator, .{
.max_entries = 1000,
.default_ttl_ms = 300000, // 5 minutes
});
defer cache_inst.deinit();

// Check cache
if (cache_inst.get(cache_key)) |cached| {
return cached;
}

// Make request and cache
const response = try transport.call(tool, request, provider);
try cache_inst.put(cache_key, response);

模拟运输(测试)```zig

var mock = utcp.MockTransportBuilder.init(allocator)
.expectCall("weather_api", .{ .output = .{ .string = "{\"temp\":20}" } })
.expectCall("translate", .{ .output = .{ .string = "Bonjour" } })
.build();
defer mock.deinit();

const response = try mock.call(tool, request, null);
try mock.verify(); // Fails if expectations not met


## 建筑```
src/
├── core/              # Core types
│   ├── tool.zig       # Tool, ToolCallRequest, ToolCallResponse
│   ├── provider.zig   # Provider, Auth types
│   ├── errors.zig     # Error types
│   ├── substitution.zig  # Variable substitution
│   ├── streaming.zig  # Streaming responses
│   ├── postprocessor.zig # Post-processors
│   ├── middleware.zig # Request/response interceptors
│   ├── circuit_breaker.zig # Circuit breaker pattern
│   ├── rate_limit.zig # Rate limiting algorithms
│   ├── cache.zig      # Response caching
│   ├── batch.zig      # Batch request execution
│   ├── validation.zig # JSON Schema validation
│   ├── debug.zig      # Debug logging
│   ├── retry.zig      # Retry policies
│   └── mock.zig       # Mock transport for testing
├── repository/
│   └── memory.zig     # InMemoryToolRepository with search
├── transports/        # Transport implementations
├── loaders/           # Tool loaders (JSON, OpenAPI)
├── cli.zig            # CLI tool
└── utcp.zig           # Public API

看 docs/ARCHITECTURE.md 详细设计。

项目状态

Go/Rust/TypeScript实现的100%特性奇偶校验

组件 · 状态
HTTP传输 · ✅ 完成
CLI传输 · ✅ 完成
MCP运输 · ✅ 完成
苏格兰和南方能源公司运输✅ 完成
WebSocket传输 · ✅ 完成
文本传输 · ✅ 完成
UDP传输 · ✅ 完成
GraphQL传输 · ✅ 完成
gRPC Web传输 · ✅ 完成
所有认证方法 · ✅ 完成
JSON/OpenAPI加载器 · ✅ 完成
流媒体 · ✅ 完成
后置处理器 · ✅ 完成
CI/CD · ✅ 完成

贡献

欢迎投稿!请随时提交拉取请求。

许可证

MIT许可证-请参阅 许可证 了解详情。

相关项目

  • UTCP规范
  • UTCP Go
  • UTCP锈蚀
  • UTCP TypeScript

常见问题

5 问
答案由本站依据条目字段整理,不引用上游原文
Zig Utcp 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

Zig Utcp 怎么在客户端里配置?

它的传输方式未标注,在客户端 MCP 配置里按官方文档填写启动命令和参数,保存后重启客户端生效。

Zig Utcp 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Zig Utcp 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

Zig Utcp 能提供哪些能力?

资料显示能力标签包括 多协议支持、工具管理、云端部署。具体工具清单以官方文档为准。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。