Mcpfleet Registry

mcpfleet注册表

用于mcpfleet的REST API后端-存储MCP服务器定义并管理身份验证令牌

  

______________________________________________________________________

概述

mcpfleet-registry 是mcpfleet生态系统的服务器端组件。它提供了一个REST API，用于存储、检索和管理MCP服务器定义。它被设计为自托管——在你自己的机器或VPS上运行。

堆栈

快速开始

Docker Compose（推荐）

git clone https://github.com/mcpfleet/mcpfleet-registry
cd mcpfleet-registry
docker compose up -d

API将于 http://localhost:8080.

手册

git clone https://github.com/mcpfleet/mcpfleet-registry
cd mcpfleet-registry
go mod tidy
go run ./cmd/registry

首次设置

注册表包含一个引导端点，用于创建您的第一个管理员令牌，而不需要身份验证。此终结点仅在数据库中不存在令牌时有效。

# Create the first admin token (run once on first startup)
curl -X POST http://localhost:8080/bootstrap \
  -H 'Content-Type: application/json' \
  -d '{"body": {"name": "admin"}}'
# => {"body": {"id": "...", "name": "admin", "token": "mcp_xxxxxxxxxxxx", "created_at": "..."}}

重要提示： 立即保存令牌！引导端点返回完整令牌，但出于安全原因，您应该安全地存储它。

然后将此令牌与mcpfleet CLI一起使用：

export MCPFLEET_REGISTRY_URL=http://localhost:8080
mcpfleet auth login
# enter your token when prompted

认证

全部 /v1/* 端点需要Bearer令牌：

Authorization: Bearer mcp_

公共路径 （无需身份验证）：

• GET /healthz --健康检查
• GET /docs --Swagger用户界面
• GET /openapi.json --OpenAPI模式
• POST /bootstrap --创建第一个管理员令牌（仅在数据库为空时有效）

API 参考

服务器

身份验证令牌

API文件

运行时，交互式API文档可在以下位置获得：

• Swagger用户界面: http://localhost:8080/docs
• OpenAPI JSON: http://localhost:8080/openapi.json

配置

发展

git clone https://github.com/mcpfleet/mcpfleet-registry
cd mcpfleet-registry
go mod tidy
go test ./...
go run ./cmd/registry

码头工人

# Build image
docker build -t mcpfleet-registry .

# Run with persistent database
docker run -d \
  -p 8080:8080 \
  -v $(pwd)/data:/data \
  -e DB_PATH=/data/registry.db \
  mcpfleet-registry

贡献

欢迎拉取请求！请先打开一个问题来讨论重大更改。

许可证

麻省理工学院