Toolhive Registry Server

MCPAI代理

提供方 stacklok

AI代理 未标注 OAuth 授权 社区 / 第三方

ToolHive注册服务器是一个用于发现、治理和控制访问MCP服务器和技能的开源服务,支持多源聚合和访问控制。

一句话选型结论

按资料字段整理

Toolhive Registry Server 属于AI代理类 MCP 服务器,传输方式未标注,OAuth 授权,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

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

工具与能力

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

能力标签

适用场景

MCP协议Go本地部署注册服务器访问控制多源聚合开源工具

安装与配置

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

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

  2. 2
    安装服务

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

  3. 3
    写入客户端配置

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

  4. 4
    验证是否可用

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

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
给代理接外部能力

让代理在任务中途调用搜索、数据库等真实工具。

多步任务编排

把一串操作拆成步骤,由代理按顺序执行。

自动化重复流程

把固定流程交给代理跑,减少手工操作。

选择建议

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

值得选的地方

  • 基础信息齐全,可以先按官方文档接入试跑。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 使用前要准备好OAuth 授权对应的凭据,并按最小权限配置。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

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

不太适合

  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Toolhive Registry Server当前 未标注 未标注 未标注 无 2026-05-17
Filesystem 560c4363 13 未标注 本地部署 无 2026-05-17
Server Everything (everything) 11 stdio · 本地进程 本地部署 有 2026-05-17
Time 7365cb6d 2 SSE · 服务端推送 远程部署 有 2026-05-18
Everything Claude Code 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Openmemory 557e1585 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

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

详细介绍

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

ToolHive注册表服务器

发现、管理和控制整个组织对MCP服务器的访问和技能

ToolHive注册表服务器将来自Git仓库、Kubernetes集群、上游注册表和内部API的MCP服务器和技能聚合到您的团队和AI客户端可以查询的命名目录中。每个目录都有自己的访问控制和审计跟踪,因此您可以决定哪些条目对哪些用户可见,并记录谁访问了什么。

它实现了官方 模型上下文协议(MCP)注册表API规范如果你不熟悉MCP:它是一种开放协议,允许AI助手连接到外部工具和数据源。此服务器是位于MCP基础架构和使用它的团队之间的治理层。

为什么选择ToolHive注册表服务器? 大多数MCP设置都是从一个简单的服务器列表开始的,没有访问控制。随着采用率的增长,您需要管理谁看到什么,聚合来自多个来源的服务器,并审核访问权限,而无需锁定到专有注册表。ToolHive注册表服务器是开源的,实现官方的MCP注册表API规范,并插入您现有的身份提供商,将基于多对映声明的授权、多源聚合和符合SIEM的审计日志记录结合在一个服务中。

了解有关ToolHive平台的更多信息→


目录

  • 特性
  • 快速入门
  • 核心概念
  • API终点
  • 配置
  • ToolHive平台
  • 文档
  • 贡献

特性

治理和访问控制

  • JWT基于索赔的可见性:控制每个注册表中每个用户或团队可以看到的MCP服务器和技能。“生产”注册表只能公开经过审查的条目,而“开发团队”注册表则显示所有内容。
  • OAuth 2.0/OIDC身份验证:插入您现有的身份提供程序(Okta、Auth0、Azure AD)。OAuth是默认设置;匿名模式可用于开发。
  • 基于角色的管理:管理源、注册表和条目的独立角色。根据特定的JWT声明确定每个角色的范围,以便团队管理自己的资源。
  • 符合SIEM标准的审计日志记录:包含所有API操作的结构化日志,具有NIST SP 800-53 AU-3兼容字段、专用文件输出和可配置事件过滤。

从任何地方聚合

  • 五种来源类型:从Git repos、上游MCP注册表、本地文件、Kubernetes集群中提取条目,或通过Admin API发布它们。
  • 从多个来源编写目录:每个登记册按优先顺序汇总一个或多个来源。一个源可以为多个注册表提供数据,因此同一个内部目录可以为具有不同可见性规则的不同团队提供服务。
  • 背景同步:使用重试逻辑按可配置的间隔轮询源。注册表保持最新状态,无需人工干预。

Kubernetes和可观察性

  • Kubernetes本地发现:内置的协调器监视命名空间中的MCP服务器CRD,并将其自动同步到注册表中。通过CRD注释、多命名空间支持和HA领导者选举进行按条目访问控制。
  • 开放遥测:开箱即用的分布式跟踪和指标。
  • 符合标准:实现官方MCP注册表API规范。说规范的客户会打破常规。
  • PostgreSQL后端:具有自动迁移功能的数据库存储。

快速入门

先决条件

  • 转到1.26或更高版本(用于从源代码构建)
  • 任务 用于构建自动化
  • PostgreSQL 16+

构建并运行```bash

Build the binary

task build

Run with Git source

thv-registry-api serve --config examples/config-git.yaml

Run with local file

thv-registry-api serve --config examples/config-file.yaml


服务器启动于 `http://localhost:8080` 默认情况下。

### Docker快速入门```bash
# Using Task (recommended - ensures fresh state)
task docker-up

# Or detached mode
task docker-up-detached

# Access the API
curl http://localhost:8080/registry/default/v0.1/servers

# Stop and clean up
task docker-down

> 注: 这 task docker-up 命令通过重建映像和清除所有卷(数据库+注册表数据)来确保重新开始。这可以防止过时的状态问题。

核心概念

来源和登记处

大多数组织在多个地方都有MCP服务器和技能——公共目录、内部Git仓库、运行实时实例的Kubernetes集群。注册表服务器使用两个原语对此进行建模: 来源 (条目来源)以及 注册表 (消费者的疑问)。

A. 来源 是指向MCP服务器和技能条目所在位置的连接。它告诉服务器“去这里找条目”。来源有五种类型:

类型 功能 示例 同步
API 从上游注册表API中提取 位于registry.modelcontextprotocol.io的官方MCP注册表 自动
Git 从Git仓库克隆条目 版本控制的内部目录 自动
文件 从本地文件系统读取 经过精心策划 registry.json 磁盘上 自动
管理 通过管理员API发布的条目 动态注册的内部服务器 按需发布
Kubernetes 发现已部署的MCP服务器 在K8s集群中运行的服务器 按需

A. 注册表 是一个命名目录,它将一个或多个源聚合到一个面向消费者的端点中。每个注册表都可以从不同的来源获取信息,并通过JWT声明实施自己的访问控制。源按顺序列出——当同一条目出现在多个源中时,列表中的第一个源获胜。

为什么他们分开:来源和登记处之间存在多对多关系。一个源可以为多个注册表提供数据,一个注册表可以从多个源中提取数据。这使您可以从相同的基础数据为不同的受众组合不同的目录:```text
Source: "official-catalog" ──┐
Source: "internal-tools" ──┼──> Registry: "production" (curated, vetted)
│
Source: "internal-tools" ──┼──> Registry: "dev-team" (everything)
Source: "k8s-deployed" ──┘


在这个例子中,“生产”注册表只公开官方目录和内部工具中经过审查的条目,而“开发团队”注册表则包括所有内容以及Kubernetes发现的实时服务器。

**配置示例:**```yaml
sources:
- name: official-catalog
api:
endpoint: https://registry.modelcontextprotocol.io
syncPolicy:
interval: "1h"

- name: internal-tools
git:
repository: https://github.com/myorg/mcp-catalog.git
branch: main
path: registry.json
syncPolicy:
interval: "30m"

registries:
- name: production
sources:
- official-catalog
- internal-tools

- name: dev-team
sources:
- internal-tools

看 配置指南 了解完整细节。

API端点

注册表API v0.1(只读,符合标准)

与上游MCP注册表API规范完全兼容:

  • GET /registry/{registryName}/v0.1/servers -列出特定注册表中的服务器
  • GET /registry/{registryName}/v0.1/servers/{name}/versions -列出服务器的所有版本
  • GET /registry/{registryName}/v0.1/servers/{name}/versions/{version} -获取特定的服务器版本

注: Git、API、File和Kubernetes源代码通过注册表API是只读的。

管理员API v1

用于管理源、注册表和条目的ToolHive特定端点:

源管理 (要求 manageSources 角色):

  • GET /v1/sources -列出所有已配置的源
  • GET /v1/sources/{name} -按名称获取源
  • PUT /v1/sources/{name} -创建或更新源
  • DELETE /v1/sources/{name} -删除源
  • GET /v1/sources/{name}/entries -列出源的条目

注册表管理 (读:认证;写要求 manageRegistries 角色):

  • GET /v1/registries -列出所有已配置的注册表及其状态
  • GET /v1/registries/{name} -获取注册表详细信息和同步状态
  • GET /v1/registries/{name}/entries -列出注册表项(需要 manageRegistries 角色)
  • PUT /v1/registries/{name} -创建或更新注册表
  • DELETE /v1/registries/{name} -删除注册表

出入管理 (要求 manageEntries 角色):

  • POST /v1/entries -发布服务器或技能条目
  • DELETE /v1/entries/{type}/{name}/versions/{version} -删除已发布的条目
  • PUT /v1/entries/{type}/{name}/claims -更新入境申报

技能扩展API(特定于工具组)

用于在注册表中发现技能的只读端点:

  • GET /registry/{registryName}/v0.1/x/dev.toolhive/skills -列出技能(分页)
  • GET /registry/{registryName}/v0.1/x/dev.toolhive/skills/{namespace}/{name} -获取技能的最新版本
  • GET /registry/{registryName}/v0.1/x/dev.toolhive/skills/{namespace}/{name}/versions -列出技能的所有版本
  • GET /registry/{registryName}/v0.1/x/dev.toolhive/skills/{namespace}/{name}/versions/{version} -获取特定技能版本

操作端点

  • GET /health -健康检查
  • GET /readiness -准备就绪检查
  • GET /version -版本信息
  • GET /v1/me -返回调用者的身份和角色
  • GET /.well-known/oauth-protected-resource -OAuth发现(RFC 9728)

用例

  • 注册API:为客户和上游集成提供符合标准的MCP发现
  • 管理员API:管理源和注册表、发布条目、查询注册表状态

请参阅 MCP注册表API规范 获取API的完整详细信息。

配置

所有配置都是通过YAML文件完成的。服务器需要 --config 旗帜。

基本示例```yaml

sources:
- name: local
file:
path: /data/registry.json

registries:
- name: my-registry
sources:
- local

auth:
mode: anonymous # Use "oauth" for production

database:
host: localhost
port: 5432
user: registry
database: registry
```

完整指南

  • 配置参考 -完整的配置选项
  • 环境变量 -使用环境变量进行配置
  • 数据库设置 -PostgreSQL配置、迁移和安全
  • 认证 -OAuth/OIDC设置和安全

ToolHive平台

注册表服务器可以独立部署,也可以作为完整注册表的一部分部署 ToolHive 平台。平台组件共同覆盖了整个MCP生命周期:

  • 注册表 (本项目)——发现和治理。了解MCP服务器和技能,谁可以访问它们,并跟踪所有操作。
  • 运行时 --部署和管理。使用注册表元数据在Kubernetes上部署MCP服务器以驱动生命周期决策。运行时部署的服务器会自动出现在注册表中。
  • 网关 --聚合和访问。通过集中身份验证、基于Cedar的授权、工具冲突解决和复合工作流将多个MCP服务器统一到一个端点中。
  • 门户 --管理UI。由注册表API支持的目录浏览、搜索和管理。

请参阅 ToolHive文档 对于完整的平台架构。

文档

  • 配置参考 -所有配置选项
  • 环境变量 -环境变量覆盖
  • 数据库设置 -PostgreSQL设置和迁移
  • 认证 -OAuth/OIDC安全
  • 可观测性 -OpenTetry跟踪和指标
  • 注册表同步 -后台同步的工作原理
  • Kubernetes部署 -K8s部署和HA
  • Docker部署 -Docker编写设置
  • API文档 -自动生成的OpenAPI文档
  • CLI参考 -命令行界面文档
  • 示例 -工作配置示例

贡献

我们欢迎捐款!请参阅 贡献指南 首先,包括开发设置、构建命令、架构概述和项目结构。

  • 行为准则 -社区指南
  • 安全政策 -报告安全漏洞

许可证

该项目根据 Apache 2.0许可证.


部分 ToolHive 项目 -简化和保护MCP服务器

常见问题

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

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

Toolhive Registry Server 怎么在客户端里配置?

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

Toolhive Registry Server 收费吗?

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

Toolhive Registry Server 需要 API Key 吗?

资料标注需要OAuth 授权认证,使用前准备好对应凭据,并按最小权限配置。

Toolhive Registry Server 能提供哪些能力?

资料显示能力标签包括 访问控制、Go、开源工具。具体工具清单以官方文档为准。

热门专题

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

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