✨ What You Get
If it's running, it's in the catalog.
No CLI needed. Agent Registry ships an MCP server — connect it to Claude Code, Cursor, or any MCP-compatible client and manage your registry conversationally.
接入你的智能体
從發布者安裝。不是 PlugMCP 端點。
遠端 URL 還是本機指令? 兩種安裝方式的差異
來自發布者
If it's running, it's in the catalog.
No CLI needed. Agent Registry ships an MCP server — connect it to Claude Code, Cursor, or any MCP-compatible client and manage your registry conversationally.
The Control Plane for AI Infrastructure Kubernetes-native registry for MCP servers, agents, skills & models
| Capability | What It Means |
|---|---|
| 🔍 Auto-Discovery | Scans your clusters for AI workloads — MCP servers, agents, skills, models — and catalogs them automatically. Zero manual work. |
| 📦 Unified Inventory | Everything in one place across dev, staging, prod. Git as the single source of truth. |
| ✍️ Create & Publish | Generate manifests via UI/API, submit for review, open PRs — or deploy directly. |
| 🚀 One-Click Deploy | Deploy from catalog to any environment. Controller handles the lifecycle. |
| 🔒 GitOps Native | GitOps and Gitless Ops workflows built-in. |
| 🌐 Multi-Cluster | Discover and deploy across clusters with workload identity. |
git clone https://github.com/den-vasyliev/agentregistry-inventory.git
cd agentregistry-inventory && make dev
🎯 That's it. UI opens at http://localhost:3000 with sample data pre-loaded.
No Kubernetes cluster needed — uses envtest (embedded etcd + kube-apiserver).
☸️ Have a cluster?
kubectl apply -k https://github.com/den-vasyliev/agentregistry-inventory/config/crd
helm install agentregistry-inventory ./charts/agentregistry -n agentregistry --create-namespace
┌─────────────────────────────────────────────────────────────┐
│ WEB UI (Next.js) │
│ embedded in controller at :8080 │
└───────────────────────────┬─────────────────────────────────┘
│ REST
▼
┌─────────────────────────────────────────────────────────────┐
│ CONTROLLER (Go Controller Runtime) │
│ ┌─────────────┐ ┌────────────────┐ ┌─────────────────────┐ │
│ │ HTTP API │ │ Reconcilers │ │ Auto-Discovery │ │
│ │ :8080 │ │ │ │ │ │
│ └─────────────┘ └────────────────┘ └─────────────────────┘ │
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────────────┐ │
│ │ MCP Server │ │ Metrics │ │ Health │ │
│ │ :8083 │ │ :8081 │ │ :8082 │ │
│ └─────────────┘ └─────────────┘ └─────────────────────┘ │
└───────────────────────────┬─────────────────────────────────┘
│ K8s API
▼
┌─────────────────────────────────────────────────────────────┐
│ CRDs (etcd) │
│ ┌─────────────────┐ ┌─────────────────┐ ┌──────────────┐ │
│ │ MCPServerCatalog│ │ AgentCatalog │ │ SkillCatalog │ │
│ └─────────────────┘ └─────────────────┘ └──────────────┘ │
│ ┌────────────────────┐ ┌─────────────────┐ │
│ │RegistryDeployment | │ DiscoveryConfig │ │
│ └────────────────────┘ └─────────────────┘ │
└─────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────┐
│ RUNTIME (Kagent + KMCP +...) │
│ Agent ↔ MCP Server ↔ Model ↔ Skills │
└─────────────────────────────────────────────────────────────┘
apiVersion: agentregistry.dev/v1alpha1
kind: MCPServerCatalog # Also: AgentCatalog, SkillCatalog, ModelCatalog
metadata:
name: filesystem-v1-0-0
namespace: agentregistry
spec:
name: "filesystem"
version: "1.0.0"
title: "Filesystem MCP Server"
description: "Provides file system access tools"
websiteUrl: "https://github.com/modelcontextprotocol/servers"
repository:
url: "https://github.com/modelcontextprotocol/servers"
source: github
packages:
- registryType: npm
identifier: "@modelcontextprotocol/server-filesystem"
version: "0.6.1"
transport:
type: stdio
remotes: # Optional: streamable-http endpoints
- type: streamable-http
url: "https://mcp.example.com/filesystem"
apiVersion: agentregistry.dev/v1alpha1
kind: RegistryDeployment
metadata:
name: filesystem-deployment
namespace: agentregistry
spec:
resourceName: "filesystem"
version: "1.0.0"
resourceType: mcp # mcp | agent
runtime: kubernetes # Required: deployment runtime
namespace: default # Target namespace
preferRemote: false # Use local package vs remote endpoint
environment: "" # Target environment (from DiscoveryConfig), empty = local cluster
config: # Optional: deployment configuration
LOG_LEVEL: "info"
The controller reconciles this → creates MCPServer/Agent CRs → tracks status.
apiVersion: agentregistry.dev/v1alpha1
kind: DiscoveryConfig
metadata:
name: multi-cluster-discovery
namespace: agentregistry
spec:
environments:
- name: production
cluster:
name: prod-gke
projectId: my-gcp-project
zone: us-central1
useWorkloadIdentity: true
provider: gcp
discoveryEnabled: true
deployEnabled: false
namespaces: [ai-workloads, agents]
resourceTypes: [MCPServer, Agent, ModelConfig]
curl http://localhost:8080/v0/servers
curl http://localhost:8080/v0/agents
curl http://localhost:8080/v0/skills
# Auth disabled by default — just POST
curl -X POST http://localhost:8080/admin/v0/servers \
-H "Content-Type: application/json" \
-d @server.json
# With auth enabled (AGENTREGISTRY_AUTH_ENABLED=true)
curl -X POST http://localhost:8080/admin/v0/servers \
-H "Authorization: Bearer your-token" \
-H "Content-Type: application/json" \
-d @server.json
The controller embeds an MCP server on :8083. Connect any MCP-compatible client (Claude Code, Cursor, etc.) to browse, deploy, and manage registry resources conversationally.
{
"mcpServers": {
"agentregistry": {
"type": "streamable-http",
"url": "http://localhost:8083/mcp"
}
}
}
{
"mcpServers": {
"agentregistry": {
"type": "streamable-http",
"url": "http://localhost:8083/mcp",
"headers": {
"Authorization": "Bearer your-token"
}
}
}
}
helm install agentregistry ./charts/agentregistry \
--namespace agentregistry \
--create-namespace \
--set replicaCount=2 \
--set controller.leaderElection=true
The admin API (/admin/*) is always authenticated and fail-closed: it requires a Bearer token from the agentregistry-api-tokens Kubernetes Secret and rejects every request when no tokens are configured, regardless of disableAuth. Public read endpoints (/v0/*) remain open. The disableAuth chart value (default false) governs Bearer-token enforcement on the MCP server and the auth flag served to the UI.
# Create token secret
kubectl create secret generic agentregistry-api-tokens \
-n agentregistry \
--from-literal=admin-token=$(openssl rand -hex 32)
# Install with auth enabled
helm install agentregistry ./charts/agentregistry \
--namespace agentregistry \
--set disableAuth=false
The embedded UI supports Azure AD login via MSAL.js — no client secret required.
# charts/agentregistry/values.yaml
azure:
tenantId: "your-tenant-id"
clientId: "your-client-id"
make dev # Full stack: controller + UI dev server
make run # Controller only with embedded UI at :8080
make test # Run test suite
make lint # gofmt + go vet
make build # Build UI + controller binary
make generate # Regenerate CRD manifests + deepcopy
Made with ❤️ by the Agent Inventory team
The Control Plane for AI Infrastructure Kubernetes-native registry for MCP servers, agents, skills & models
工具
尚無工具清單。遠端伺服器會在首次健康檢查後取得工具清單。
常見問題
在本頁複製適用於 Cursor、Claude Desktop、Claude Code 或 VS Code 的 stdio 設定。它使用發布者的安裝方式,而不是 PlugMCP 代理伺服器。
這筆記錄未列出必要的環境變數。
Agentregistry Inventory 透過 stdio 在本機執行。
上次檢查時間:2026-10-27。 The Control Plane for AI Infrastructure Kubernetes-native registry for MCP servers, agents, skills & models