GitHub
Connect AI assistants to GitHub - manage repos, issues, PRs, and workflows through natural language.
作者提供的说明(英文原文)
Read-only Cilium and Hubble network observability and flow investigation for Kubernetes.
这三项永远不会合并成一个分数:意见、测量和人气是不同的东西。
我们还没有为它写通俗的介绍。下面是我们从注册中心读取到的事实。
选择你使用的 AI 应用,然后复制设置。
PAQTRA_URL, PAQTRA_TOKEN, PAQTRA_USERNAME, PAQTRA_PASSWORD标为机密的值是你账户的钥匙。千万不要分享给别人,也不要粘贴到聊天里。
你需要
你用的是哪个应用?
在上方选择你的应用。我们会记住它,下次按钮会显示“安装到 …”。
打开 Claude Desktop → Settings → Developer → Edit Config,把下面的内容粘贴到 claude_desktop_config.json
{
"mcpServers": {
"paqtra": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"PAQTRA_URL",
"-e",
"PAQTRA_TOKEN",
"-e",
"PAQTRA_USERNAME",
"-e",
"PAQTRA_PASSWORD",
"ghcr.io/zyvorai/paqtra-mcp:2.2.3"
],
"env": {
"PAQTRA_URL": "your-value",
"PAQTRA_TOKEN": "your-value",
"PAQTRA_USERNAME": "your-value",
"PAQTRA_PASSWORD": "your-value"
}
}
}
}在终端中运行这条命令
claude mcp add paqtra --env PAQTRA_URL=your-value --env PAQTRA_TOKEN=your-value --env PAQTRA_USERNAME=your-value --env PAQTRA_PASSWORD=your-value -- docker run -i --rm -e PAQTRA_URL -e PAQTRA_TOKEN -e PAQTRA_USERNAME -e PAQTRA_PASSWORD ghcr.io/zyvorai/paqtra-mcp:2.2.3运行前请先填写空着的值。
粘贴到项目中的 .cursor/mcp.json,或 ~/.cursor/mcp.json
{
"mcpServers": {
"paqtra": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"PAQTRA_URL",
"-e",
"PAQTRA_TOKEN",
"-e",
"PAQTRA_USERNAME",
"-e",
"PAQTRA_PASSWORD",
"ghcr.io/zyvorai/paqtra-mcp:2.2.3"
],
"env": {
"PAQTRA_URL": "your-value",
"PAQTRA_TOKEN": "your-value",
"PAQTRA_USERNAME": "your-value",
"PAQTRA_PASSWORD": "your-value"
}
}
}
}浏览器会先询问是否打开应用,然后应用会显示设置并请你确认。密钥的值会留空,由你自己填写。
粘贴到项目中的 .vscode/mcp.json
{
"servers": {
"paqtra": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"PAQTRA_URL",
"-e",
"PAQTRA_TOKEN",
"-e",
"PAQTRA_USERNAME",
"-e",
"PAQTRA_PASSWORD",
"ghcr.io/zyvorai/paqtra-mcp:2.2.3"
],
"env": {
"PAQTRA_URL": "your-value",
"PAQTRA_TOKEN": "your-value",
"PAQTRA_USERNAME": "your-value",
"PAQTRA_PASSWORD": "your-value"
}
}
}
}浏览器会先询问是否打开应用,然后应用会显示设置并请你确认。密钥的值会留空,由你自己填写。
这个服务器在你的电脑上运行,而 ChatGPT 只能连接互联网上的服务器。请选择其他应用。
你的选择通过 Cookie 保存在这台设备上,无需账户。
PAQTRA_USERNAME env这些设置是根据作者在注册中心的条目生成的。如果 README 的写法不同,请以 README 为准。
它在你的电脑上运行;安装后,工具列表会显示在你的 AI 应用中。
我们检查的是任何人都能看到的信息;我们没有阅读代码。不适用的检查项不计入总数。 · 检查于 2026年11月9日
注册名称已通过 GitHub 账户 zyvorai 验证,该账户拥有此仓库
我们还没有从 GitHub 读取这个仓库
我们还没有从 GitHub 读取这个仓库
它在你的电脑上运行,没有互联网端点
在你的电脑上运行,改用本地设置
它在你的电脑上运行;我们只能读取互联网端点的工具列表
与注册中心里这个分类中所有活跃的服务器比较。只有当发布者拥有该仓库时,星标数才计入。
它在 1 项适用的基础检查中通过了 1 项。我们没有阅读代码。在添加密钥或令牌之前,请先看看这个服务器要求哪些权限,并使用只具备所需权限的密钥。
你需要填写:PAQTRA_URL, PAQTRA_TOKEN, PAQTRA_PASSWORD
它在你的电脑上运行。你的 AI 应用会在需要时启动它,数据不会经过作者的服务器(除非它自己调用在线服务)。
GitHub 仓库最后更新于–,最新版本(2.2.3)于24天前进入注册中心。
支持 MCP 的应用,例如 Claude Desktop、Claude Code、Cursor 和 VS Code。你的电脑上还需要有 Docker。
同一分类中有:GitHub, Desktop Commander, Cloudflare MCP
同一分类中其他作者的服务器,按星标数排序。
如何看卡片:↓ 每周下载量i★ GitHub 星标i三大支柱:评价 · 检查 · 使用情况i更新 = 最新版本发布到注册中心的时间i
Connect AI assistants to GitHub - manage repos, issues, PRs, and workflows through natural language.
MCP server for terminal commands, file operations, and process management
按原文从作者的仓库复制。PopNx MCP 没有审查或背书其内容。HTML、图片和脚本已被移除。链接会离开本站。
Cilium-native network observability and operations for Kubernetes. Every Hubble flow stored and searchable, drops explained by Cilium reason, CiliumNetworkPolicy changes simulated before you apply them, and enforcement left with Cilium.
Web dashboard · REST API · Terminal TUI · Why denied? on any flow · Read-only toward the datapath · Free, Apache 2.0
📖 [Read the full docs](https://zyvorai.github.io/zyvor-paqtra/): quickstart, architecture, the Cilium boundary, and a product tour.
| Per-second metrics platform (Unreleased) | Every agent streams host, network, disk, pod, process-group and app metrics each second; the API keeps them in 1 s / 1 min / 1 h tiers, adds Hubble flow, verdict, drop, HTTP and DNS series, flags anomalies per dimension, runs 45 built-in metric alerts and exports to Prometheus remote write, OTLP or Graphite. docs/metrics.md |
| MCP server (2.2.3) | paqtra-mcp, a read-only stdio MCP server with 39 tools, lets an AI agent query a Paqtra deployment with the caller's own credentials. Published from the v2.2.3 release as ghcr.io/zyvorai/paqtra-mcp:2.2.3 and to the MCP Registry as io.github.zyvorai/paqtra. docs/mcp-integration.md |
| Installs like `cilium-cli` (2.2.0) | The Helm chart is compiled into the paqtra binary: install, upgrade, status --wait, --with-cilium, prerequisite checks, doctor. |
| Signed releases (2.2.0) | Static musl Linux and macOS binaries with sha256sums.txt, a cosign keyless signature, an SBOM and a Homebrew formula. |
| Rule-level policy editing (2.2.0) | Add, replace or delete one rule of a CiliumNetworkPolicy, with ?dry_run=true, conflict detection and audit entries. |
| Cilium Insights (2.2.0) | Read-only views of Cilium features, Hubble nodes, BGP, LB-IPAM, L2, pod IP pools, CIDR groups and Gateway API resources. |
| Change impact and shareable investigations (2.2.0) | Before/after flow correlation for a change, and investigation bundles with a time-limited, redacted share link. |
| Why denied? (2.1.0) | From any dropped flow: identities, candidate CNP/CCNP, the drop reason and a draft allow. |
| Large flow stores stay fast (2.2.1, 2.2.2) | Reads never block ingest, every read has a deadline, and recent-window queries go through the time index. |
Full history: CHANGELOG.md.
| When this happens… | Paqtra gives you… |
|---|---|
| A request fails and nobody knows why | Path explain and Why denied? on any flow, with confidence-tagged evidence |
| Cilium drops packets and the reason is buried | Drop analytics by Cilium reason, plus a per-packet explanation |
| You want to change policy without breaking things | Simulate a CiliumNetworkPolicy against indexed flows before you apply it |
| The flow you need scrolled out of Hubble minutes ago | A continuous Hubble follow-stream into a local SQLite flow store, queried by time window |
| Network tooling that touches the datapath is a non-starter | Read-only toward Cilium: no BPF map writes, no program attach, not a second CNI |
| Every Cilium add-on needs its own install story | paqtra install with the Helm chart built in, paqtra status --wait, paqtra doctor |
Paqtra is observe-first. Flows come from Hubble; node-local enrichment may read the BPF map inventory. Enforcement stays with Cilium: policy changes go through CiliumNetworkPolicy (CNP), never through Paqtra's own datapath.
Paqtra does not replace Hubble; it reads Hubble's flows through Hubble Relay and builds on them.
| Paqtra | Hubble UI (ships with Cilium) | |
|---|---|---|
| Flow source | Hubble Observer gRPC follow-stream | Hubble Relay |
| Flow history | Local SQLite flow store, queried by time window | Live flows from Hubble's in-memory buffers |
| Service map | Service map and observed-traffic topology | Service map per namespace |
| "Why can't A reach B?" | Path explain with observed / inferred / unavailable evidence | Inspect the flows yourself |
| Drops | Drop analytics by Cilium reason, Why denied? per flow | Verdict and drop reason on each flow |
| Policy | Rule builder, YAML editor, AutoPolicy, simulate, apply as CNP | Not a policy editor |
| Interfaces | Web dashboard, REST API, terminal UI, CLI | Web UI (plus the hubble CLI) |
| Choose Hubble UI when | Live flows and a service map are all you need and you want only what ships with Cilium |
Captured against a live lab cluster with Cilium and Hubble. Full tour on the docs site gallery.
Live Hubble flows with verdict coloring and WebSocket streaming, a service map and an observed-traffic topology built from real flows. Real L7 DNS query/rcode/latency when Cilium DNS visibility is on; L4-only never invents SERVFAIL. Capabilities →
Per-second node metrics next to the flows: CPU, memory, disks, interfaces, TCP, conntrack, pod cgroups, process groups (by comm only) and annotated apps (nginx, Redis, Envoy, CoreDNS, etcd, any Prometheus endpoint), with live canvas charts, per-dimension anomaly detection, "what changed here?" correlation and Netdata-style metric alerts that notify but never apply policy. paqtra metrics … covers the same from the terminal. Metrics → · Alerts → · Anomalies → · Apps →
Ask "why can't A reach B?" and get an answer with observed, inferred or unavailable evidence labels. Click Why denied? on any dropped flow. Investigate → · Root cause →
The dashboard also includes real kernel eBPF data views powered by bpftool: conntrack tables, policy maps, IP cache, LB maps and drop analytics. All read-only. eBPF integration →
A visual rule builder, a YAML editor, ML-powered AutoPolicy and an evidence-backed simulator, all applied as CiliumNetworkPolicy through the Kubernetes API. Cilium enforces. AutoPolicy → · Simulator →
Also included: compliance audits (CIS, NIST, SOC 2), anomaly detection, chaos engineering, canary deployments and multi-cluster views. Everything Paqtra does →
paqtra-mcp is a stdio Model Context Protocol server that lets an AI agent (Claude Desktop, Hermes Agent, any MCP client) read a running Paqtra deployment. It exposes 39 tools, all read-only with respect to the cluster: no policy apply, edit or delete, no chaos, no healer fix, no cluster sync, no flow-store purge. The two investigate tools store an evidence bundle in the API and nothing else. Every call is made with your own API credentials, so RBAC and namespace scoping apply.
io.github.zyvorai/paqtra (published from the v2.2.3 release)ghcr.io/zyvorai/paqtra-mcp:2.2.3PAQTRA_URL, plus PAQTRA_TOKEN or PAQTRA_USERNAME / PAQTRA_PASSWORD; use a viewer-role account.Setup, tool scope and the protocol: docs/mcp-integration.md.
| Component | Port | Role |
|---|---|---|
API (ghcr.io/zyvorai/paqtra-api) | 9191 | Rust + Axum REST API: Hubble ingest into the flow store, investigate, drops, policy, JWT auth |
UI (ghcr.io/zyvorai/paqtra-ui) | 8443 | React dashboard, served over TLS by default |
Node agent (ghcr.io/zyvorai/paqtra) | 9192 | DaemonSet on every node: health and read-only map and program inventory |
paqtra CLI | — | Install, upgrade, status, doctor, ui, hubble enable; the Helm chart is built in |
Ports are the Helm chart defaults in chart/values.yaml. Architecture in depth: docs/architecture.md · docs/web-architecture.md.
Hard boundaries, enforced by review and repeated in AGENTS.md:
cil_* programs.cil_* / netra_* / other).Details: docs/cilium-brotherhood.md and docs/ebpf-integration.md.
Prerequisites: a Kubernetes cluster and a kube-context. Cilium with Hubble Relay is required too; paqtra install --with-cilium sets it up if it is missing.
# Install the CLI (downloads, verifies and installs the latest release)
curl -fsSL https://raw.githubusercontent.com/zyvorai/paqtra/main/install.sh | sh # or: brew install zyvorai/tap/paqtra
paqtra install # add --with-cilium if the cluster has no Cilium yet paqtra status --wait paqtra ui # open the console
paqtra doctor
Build from source, Docker, Helm, environment variables and testing: [Install guide](docs/install.md) · CLI reference: docs/cli.md.
![Paqtra
只显示了开头部分;其余内容请在仓库中阅读