toolhive-registry-server

概述

ToolHive 注册服务器将来自 Git 仓库、Kubernetes 集群、上游注册表和内部 API 的 MCP 服务器和技能聚合到命名目录中，并提供访问控制和审计跟踪。它实现了官方的模型上下文协议（MCP）注册表 API 规范，提供基于 JWT 的可见性控制、OAuth 2.0/OIDC 身份验证、基于角色的管理以及符合 SIEM 的审计日志。服务器支持五种源类型（API、Git、文件、托管、Kubernetes），并允许从多个源组合目录，为不同团队提供适当的可见性规则。

试试问 AI

装完之后，这里有 5 个你可以让 AI 做的事：

• list_servers

  List all MCP servers from a specific registry

  试试:List all servers in the production registry试试:What MCP servers are available in the dev-team registry?
• get_server_versions

  List all versions of a specific MCP server

  试试:Show me all versions of the postgres-server试试:What versions are available for the github-tools server?
• get_server_version

  Get details of a specific version of an MCP server

  试试:Get details for version 1.2.3 of the file-tools server试试:Show me the metadata for github-tools version 2.1.0
• list_skills

  List all skills available in a registry

  试试:Show me all skills in the production registry试试:What skills are available in the dev catalog?
• get_skill

  Get details of a specific skill

  试试:Get the latest version of the data-processing skill in the analytics namespace试试:Show me the skill 'file-operations' in the dev namespace
• list_skill_versions

  List all versions of a specific skill

  试试:Show me all versions of the report-generator skill试试:What versions exist for the image-processor skill?
• get_skill_version

  Get details of a specific version of a skill

  试试:Get details for version 3.1 of the data-transformation skill试试:Show me metadata for the document-generator version 2.0
• list_sources

  List all configured data sources for the registry

  试试:Show me all configured sources试试:What Git repositories are being used as sources?
• list_registries

  List all configured registries with their status

  试试:Show all registries and their sync status试试:What registries are configured in this system?
• publish_entry

  Publish a new server or skill entry to the registry

  试试:Publish a new server entry for our internal tools试试:Add a new skill to the registry
• delete_entry

  Delete a specific version of a published entry

  试试:Remove version 1.0 of the old-file-server试试:Delete the outdated skill version 2.3
• update_entry_claims

  Update access claims for a registry entry

  试试:Update access claims for the production database server试试:Modify visibility rules for the reporting skills

可对比工具

安装

task build

# 使用 Git 源运行
thv-registry-api serve --config examples/config-git.yaml

# 使用本地文件运行
thv-registry-api serve --config examples/config-file.yaml

task docker-up

{
  "mcpServers": {
    "toolhive": {
      "command": "thv-registry-api",
      "args": ["serve", "--config", "path/to/config.yaml"]
    }
  }
}

FAQ

源（sources）和注册表（registries）有什么区别？

源是连接到 MCP 服务器和技能条目所在位置的地方（Git 仓库、Kubernetes 集群等）。注册表是将一个或多个源聚合到具有自己访问控制规则的单个面向消费者的端点的命名目录。

这个服务器是否实现了官方的 MCP 注册表 API 规范？

是的，它完全实现了官方的 MCP 注册表 API 规范（v0.1）用于读取操作。它还提供额外的 ToolHive 特定 API 用于管理和技能发现。

toolhive-registry-server 对比