当前位置：首页 > news >正文

开源项目推荐：MCP Registry——管理MCP服务器的利器

news 2025/6/29 10:42:24

探索MCP Registry：未来模型上下文协议的核心注册服务

随着人工智能技术的迅速发展，机器学习模型的管理和配置变得愈发重要。今天，我们将探索一个颇具潜力的开源项目——MCP Registry。这是一个由社区驱动的注册服务，专为模型上下文协议（Model Context Protocol，简称MCP）服务器设计。它提供了一种集中化的解决方案，用于管理和发现各种MCP实现。

项目概述

MCP Registry旨在成为MCP服务器的中心存储库，支持关联元数据、配置和功能的管理。作为一项社区驱动的服务，其目标是通过提供一个统一的入口点，让用户可以轻松地发现和管理不同的MCP部署及其功能。

主要功能

MCP Registry拥有一套丰富的功能，帮助开发人员有效地管理MCP服务器：

RESTful API：支持对MCP注册项的增删改查操作。
健康检查端点：提供服务监控能力。
多种环境配置支持：灵活适应不同的部署环境。
优雅的关闭处理机制：确保服务停止期间的安全性。
MongoDB及内存数据库支持：多样化的数据存储选项。
全面的API文档：通过Swagger/OpenAPI提供的交互式文档，可在浏览器中直接测试API。
分页支持：易于浏览大量注册项。

应用场景

注册项管理

通过MCP Registry的RESTful API，用户可以高效地进行MCP服务器的注册项管理，包括列出、检索、创建、更新和删除。这为组织中多个MCP实例的集中管理提供了便利。

健康监控

开发者可以使用健康检查端点，快速检查MCP注册服务的当前状态。这对确保服务的稳定性和快速故障排除大有裨益。

本地及云端部署

由于支持Docker及多种环境配置，用户可以根据需要选择合适的部署方案，无论是本地开发环境还是云端生产环境。

实践指导

准备工作

在动手之前，你需要准备好以下环境：

Go 1.18或更高版本
MongoDB
Docker（推荐用于开发）

快速启动

借助Docker Compose，您可以在几分钟内启动并运行MCP注册服务和MongoDB。如下命令可帮助迅速开始：

# 构建Docker镜像
docker build -t registry .# 使用docker compose启动注册服务和MongoDB
docker compose up

运行后，服务将在本地暴露在8080端口。

本地构建

若您希望在无需Docker的情况下运行服务，也可以选择使用Go本地构建：

# 构建注册服务可执行文件
go build ./cmd/registry

完成后，registry二进制文件将在当前目录生成。记得确保本地或Docker中的MongoDB服务在运行中。

项目结构

MCP Registry的代码库组织良好，以下是主要目录结构的概览：

api/：OpenApi规范
cmd/：应用程序入口点
config/：配置文件
internal/：应用程序私有代码
- 包含HTTP服务器、请求处理器、数据模型及业务逻辑
pkg/：公共库
scripts/：实用脚本
tools/：命令行工具

API文档及交互

Swagger UI提供了全面的API文档，您可以通过以下路径访问并直接在浏览器中测试API：

/v0/swagger/index.html

关键API端点

健康检查

通过GET /v0/health可以获取服务的健康状态：
```
{"status": "ok"
}
```
列出注册的服务器

使用GET /v0/servers可获取注册的MCP服务器项列表，支持分页功能。
发布服务器信息

使用POST /v0/publish可以将新的MCP服务器信息发布至注册表。发布操作需要通过Bearer token进行认证。

配置与测试

服务的配置可以通过环境变量进行：

变量	描述	默认值
`MCP_REGISTRY_APP_VERSION`	应用版本	`dev`
`MCP_REGISTRY_DATABASE_TYPE`	数据库类型	`mongodb`
`MCP_REGISTRY_COLLECTION_NAME`	MongoDB集合名称	`servers_v2`
`MCP_REGISTRY_DATABASE_NAME`	MongoDB数据库名	`mcp-registry`

在开发过程中，你可以使用提供的测试脚本确保API端点的正确性：

./scripts/test_endpoints.sh