Agentregistry Inventory

The Control Plane for AI Infrastructure

Kubernetes-native registry for MCP servers, agents, skills & models

🚀 Quick Start • ✨ Features • 🏗️ Architecture • 📚 Docs • 📝 Blog

✨ 所得

Automatically indexes MCP servers, agents, skills, and models across clusters.

如果它正在运行，它在目录中。

不需要CLI。 代理注册处发货 MCP服务器 --将其连接到Claude Code、Cursor或任何兼容MCP的客户端，并以对话方式管理您的注册表。

🚀 快速开始

运行开发环境的一个命令

git clone https://github.com/den-vasyliev/agentregistry-inventory.git
cd agentregistry-inventory && make dev

🎯 就这样 UI在以下位置打开http://localhost:3000预加载样本数据。 不需要Kubernetes集群——使用envtest（嵌入式etcd+kube-apiserver）。

☸️ 有集群吗？

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                 │
└─────────────────────────────────────────────────────────────┘

📚 CRD参考

• Kgateway -用于人工智能流量的网关API
• 卡金特 --Kubernetes AI代理运行时
• KMCP --MCP服务器操作员

______________________________________________________________________

📋 库存CRD示例

📦 发布目录条目

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"

控制器对此进行协调→ 创建MCPServer/代理CR→ 跟踪状态。

🌍 多集群发现

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]

→ 完整的自动发现文档

______________________________________________________________________

🔌 API 参考

公共API（只读，不需要身份验证）

curl http://localhost:8080/v0/servers
curl http://localhost:8080/v0/agents
curl http://localhost:8080/v0/skills

管理员API（写入）

# 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

______________________________________________________________________

🤖 MCP服务器

控制器在以下位置嵌入MCP服务器 :8083.连接任何兼容MCP的客户端（Claude Code、Cursor等），以对话方式浏览、部署和管理注册表资源。

连接（禁用身份验证，默认）

{
  "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"
      }
    }
  }
}

工具

→ 完整的MCP文档 | → MCP认证

______________________________________________________________________

☸️ 生产部署

helm install agentregistry ./charts/agentregistry \
  --namespace agentregistry \
  --create-namespace \
  --set replicaCount=2 \
  --set controller.leaderElection=true

密钥配置

______________________________________________________________________

🔐 认证

认证是 默认情况下禁用.启用时(disableAuth: false)，管理员API和MCP服务器需要来自 agentregistry-api-tokens Kubernetes的秘密。

对于带有网关的生产部署，请使用 代理网关 在控制器前处理Azure AD JWT验证--保持 disableAuth: true 在后端，让网关强制执行身份验证。

启用承载令牌身份验证

# 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

Azure AD（社交媒体浏览器PKCE）

嵌入式UI支持通过MSAL.js登录Azure AD，无需客户端密码。

# charts/agentregistry/values.yaml
azure:
  tenantId: "your-tenant-id"
  clientId: "your-client-id"

→ 完整的Azure AD设置

______________________________________________________________________

🧪 发展

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

______________________________________________________________________

🔗 生态系统

______________________________________________________________________

💬 加入社区

• 🐛 问题 --报告错误或请求功能
• 🤝 PR欢迎 --我们热爱贡献！

______________________________________________________________________

⬆ 返回页首

由以下材料制成❤️ 由代理库存团队负责

MIT许可证