AI导哈

MCP注册表API服务

一个只读的API服务器，用于从远程JSON文件提供模型上下文协议（MCP）注册表数据，支持定期刷新和RESTful API查询。

  • by jlucaspains
  • Go
  • 本地部署
  • 更新于
在 GitHub 查看 jlucaspains/basic-mcp-registry

使用说明

MCP注册表API服务器

只读API服务器，用于从远程JSON文件提供模型上下文协议（MCP）注册表数据。

概述

此Go服务通过RESTful API下载、验证并提供MCP服务器注册表数据。它定期刷新注册表数据以保持最新状态，而不需要重新部署。

特性

  • 从可配置的URL下载注册表JSON
  • 根据MCP规范验证数据
  • 用于查询服务器和版本的RESTful API
  • 定期自动刷新
  • 容器编排的健康和准备状态探测
  • 平滑关闭
  • 结构化JSON日志记录
  • 浏览器客户端的CORS支持

配置

所有配置都是通过环境变量完成的：

所需的环境变量

  • REGISTRY_URL -下载注册表JSON文件的URL

    • 例子： https://raw.githubusercontent.com/example/mcp-registry/main/registry.json

  • REFRESH_INTERVAL -多久刷新一次注册表数据

    • 格式：Go持续时间字符串（例如。， 5m, 1h, 30s)
    • 例子： 5m （每5分钟刷新一次）

可选环境变量

  • PORT -HTTP服务器端口（默认值： 8080)

    • 有效范围：1-65535
    • 例子： 8080

  • LOG_LEVEL -日志记录级别（默认值： info)

    • 有效值： debug, info, warn, error
    • 例子： info

API终点

注册表端点

  • GET /v0.1/servers -列出所有具有分页和筛选功能的服务器

    • 查询参数：
      • cursor -分页光标（整数索引）
      • limit -每页显示结果（默认值：30，最大值：100）
      • search -按服务器名称子字符串筛选（不区分大小写）
      • version -按精确版本匹配进行筛选
      • updated_since -按更新时间戳过滤（RFC3339格式）
    • 答复： ServerListResponse 具有服务器数组和分页元数据

  • GET /v0.1/servers/{serverName}/versions -获取特定服务器的所有版本

    • 退货： ServerListResponse 对于所有版本，按最新版本排序

  • GET /v0.1/servers/{serverName}/versions/{version} -获取特定版本

    • 支持特殊版本 latest 获取最新版本
    • 退货： ServerResponse 使用单个服务器对象

健康终点

  • GET /health -始终返回200 OK {"status": "ok"}

    • 用于活性探针

  • GET /ready -加载注册表时返回200 OK，否则返回503

    • 用于准备就绪探头

快速开始

# Build
go build -o mcp-registry-server

# Run
export REGISTRY_URL="https://example.com/registry.json"
export REFRESH_INTERVAL="5m"
./mcp-registry-server

Docker部署

构建Docker镜像

docker build -t mcp-registry-server:latest .

使用Docker运行

docker run -d \
  --name mcp-registry \
  -p 8080:8080 \
  -e REGISTRY_URL="https://example.com/registry.json" \
  -e REFRESH_INTERVAL="5m" \
  -e LOG_LEVEL="info" \
  mcp-registry-server:latest

检查健康

# Liveness check
curl http://localhost:8080/health

# Readiness check
curl http://localhost:8080/ready

# List servers
curl http://localhost:8080/v0.1/servers

Azure容器应用程序部署

创建容器应用程序

az containerapp create \
  --name mcp-registry \
  --resource-group my-resource-group \
  --environment my-environment \
  --image myregistry.azurecr.io/mcp-registry-server:latest \
  --target-port 8080 \
  --ingress external \
  --env-vars \
    REGISTRY_URL="https://example.com/registry.json" \
    REFRESH_INTERVAL="5m" \
    LOG_LEVEL="info" \
  --cpu 0.5 \
  --memory 1.0Gi

配置健康探测器

az containerapp update \
  --name mcp-registry \
  --resource-group my-resource-group \
  --set-env-vars \
    REGISTRY_URL="https://example.com/registry.json" \
    REFRESH_INTERVAL="5m" \
  --health-probe-liveness-path="/health" \
  --health-probe-readiness-path="/ready"

Azure容器实例部署

az container create \
  --resource-group my-resource-group \
  --name mcp-registry \
  --image myregistry.azurecr.io/mcp-registry-server:latest \
  --dns-name-label mcp-registry-unique \
  --ports 8080 \
  --environment-variables \
    REGISTRY_URL="https://example.com/registry.json" \
    REFRESH_INTERVAL="5m" \
    LOG_LEVEL="info" \
  --cpu 1 \
  --memory 1

发展

# Install dependencies
go mod download

# Build
go build

# Run tests
go test ./...

# Run with local development settings
export REGISTRY_URL="https://example.com/registry.json"
export REFRESH_INTERVAL="1m"
export PORT="8080"
export LOG_LEVEL="debug"
go run main.go

MCP注册表规范

此服务器实现了MCP注册表规范。有关注册表JSON格式的详细信息，请参阅 MCP注册表文件.

许可证

麻省理工学院

相关 MCP