Model Context Protocol (MCP) Registry服务介绍与使用指南

技术背景

MCP Registry 是一个由社区驱动的 Model Context Protocol (MCP) 服务器的注册服务。该项目目前处于开发的早期阶段，旨在提供一个集中的存储库，用于管理 MCP 服务器的条目，方便对各种 MCP 实现进行发现和管理。

实现步骤

1. 前提条件

• Go 1.18 或更高版本
• MongoDB
• Docker（可选，但开发时推荐使用）

2. 运行服务

使用 Docker Compose

这是启动注册服务最简单的方法，它会在本地 Docker 环境中设置 MCP Registry 服务、导入种子数据并运行 MongoDB。

# 构建 Docker 镜像
docker build -t registry .

# 使用 Docker Compose 启动注册服务和 MongoDB
docker compose up

此操作会在 Docker 中启动 MCP Registry 服务和 MongoDB，并将服务暴露在 8080 端口。

本地运行

如果不想使用 Docker，可以直接使用 Go 来构建和运行服务。

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

这将在当前目录下创建一个 registry 二进制文件。需要确保本地或 Docker 中有 MongoDB 正在运行。默认情况下，服务将在 http://localhost:8080 上运行。

核心代码

构建 Docker 镜像

docker build -t registry .

使用 Docker Compose 启动服务

docker compose up

使用 Go 构建可执行文件

go build ./cmd/registry

最佳实践

配置服务

可以使用环境变量来配置服务，以下是一些常用的环境变量及其默认值：

Variable Description Default
MCP_REGISTRY_APP_VERSION Application version dev
MCP_REGISTRY_DATABASE_TYPE Database type mongodb
MCP_REGISTRY_COLLECTION_NAME MongoDB collection name servers_v2
MCP_REGISTRY_DATABASE_NAME MongoDB database name mcp-registry
MCP_REGISTRY_DATABASE_URL MongoDB connection string mongodb://localhost:27017
MCP_REGISTRY_GITHUB_CLIENT_ID GitHub App Client ID
MCP_REGISTRY_GITHUB_CLIENT_SECRET GitHub App Client Secret
MCP_REGISTRY_LOG_LEVEL Log level info
MCP_REGISTRY_SEED_FILE_PATH Path to import seed file data/seed.json
MCP_REGISTRY_SEED_IMPORT Import seed.json on first run true
MCP_REGISTRY_SERVER_ADDRESS Listen address for the server :8080

测试服务

可以运行测试脚本来验证 API 端点：

./scripts/test_endpoints.sh

也可以指定特定的端点进行测试：

./scripts/test_endpoints.sh --endpoint health
./scripts/test_endpoints.sh --endpoint servers

常见问题

1. 服务无法启动

• 检查 MongoDB 是否正常运行，确保连接字符串正确。
• 检查环境变量是否正确配置。

2. API 请求失败

• 检查请求的 URL 和参数是否正确。
• 检查服务的健康状态，可通过 /v0/health 端点进行检查。

3. 数据未正确导入

• 确保种子文件路径正确，并且服务配置中允许导入种子数据。