agentdrop-mcp-server

MCP 注册表

MCP 注册表为 MCP 客户端提供 MCP 服务列表，就像 MCP 服务的应用商店。

📤 发布我的 MCP 服务 | ⚡️ 实时 API 文档 | 👀 生态愿景 | 📖 完整文档

开发状态

2025-10-24 更新：注册表 API 已进入 API 冻结（v0.1） 🎉。在接下来的一个月或更长时间内，API 将保持稳定，不会有破坏性变更，方便集成方放心地实现支持。此冻结适用于 v0.1，开发工作则会继续推进 v0。我们将利用这段时间在真实集成中验证 API，并收集反馈，以便完善 v1，推动其正式发布。感谢大家的贡献与耐心——正是你们的参与，让我们走到了今天！

2025-09-08 更新：注册表已开启预览 🎉（公告博文）。虽然系统现在更加稳定，但这仍是预览版，可能会发生破坏性变更或数据重置。之后将推出正式发布（GA）版本。欢迎在 GitHub 讨论区或 #registry-dev Discord 中分享反馈（此处查看加入详情）。

当前主要维护者：

• Adam Jones（Anthropic）@domdomegg
• Tadas Antanavicius（PulseMCP）@tadasant
• Toby Padilla（GitHub）@toby
• Radoslav (Rado) Dimitrov（Stacklok）@rdimitrov

参与贡献

我们通过多个渠道协作——请参阅 modelcontextprotocol.io/community/communication。

想法通常（但并非总是）会沿着以下流程推进：

• Discord - 实时社区讨论
• 讨论区 - 提出并讨论产品／技术需求
• 问题 - 跟踪范围明确的技术工作
• 拉取请求 - 为问题贡献代码

快速开始：

先决条件

• Docker
• Go 1.24.x
• ko - Go 容器镜像构建工具（安装说明）
• golangci-lint v2.4.0

运行服务

# Start full development environment
make dev-compose

这会使用 PostgreSQL 在 localhost:8080 启动注册表。数据库使用临时存储，每次重启容器都会重置，确保开发和测试环境保持干净。

**注意：**注册表使用 ko 构建容器映像。make dev-compose 命令会自动使用 ko 构建注册表映像，并在启动服务前将其加载到本地 Docker 守护进程中。

默认情况下，注册表会从生产 API 中载入经过筛选的服务器子集（以加快启动速度）。这样可确保本地环境与生产环境的行为一致，且所有种子数据都通过验证。离线开发时，可以使用文件载入种子数据而不进行验证：MCP_REGISTRY_SEED_FROM=data/seed.json MCP_REGISTRY_ENABLE_REGISTRY_VALIDATION=false make dev-compose。

可以通过 docker-compose.yml 中的环境变量配置此设置；请参阅 .env.example 以了解相关配置。

# Run latest stable release
docker run -p 8080:8080 ghcr.io/modelcontextprotocol/registry:latest

# Run latest from main branch (continuous deployment)
docker run -p 8080:8080 ghcr.io/modelcontextprotocol/registry:main

# Run specific release version
docker run -p 8080:8080 ghcr.io/modelcontextprotocol/registry:v1.0.0

# Run development build from main branch
docker run -p 8080:8080 ghcr.io/modelcontextprotocol/registry:main-20250906-abc123d

发布服务器

我们构建了一个简单的 CLI，用于发布服务器。你可以这样使用：

# Build the latest CLI
make publisher

# Use it!
./bin/mcp-publisher --help

更多详情请参阅发布者指南。

其他命令

# Run lint, unit tests and integration tests
make check

还有一些实用的开发命令。运行 make help 了解详情，或查看 Makefile。

架构

项目结构

├── cmd/                     # Application entry points
│   └── publisher/           # Server publishing tool
├── data/                    # Seed data
├── deploy/                  # Deployment configuration (Pulumi)
├── docs/                    # Documentation
├── internal/                # Private application code
│   ├── api/                 # HTTP handlers and routing
│   ├── auth/                # Authentication (GitHub OAuth, JWT, namespace blocking)
│   ├── config/              # Configuration management
│   ├── database/            # Data persistence (PostgreSQL)
│   ├── service/             # Business logic
│   ├── telemetry/           # Metrics and monitoring
│   └── validators/          # Input validation
├── pkg/                     # Public packages
│   ├── api/                 # API types and structures
│   │   └── v0/              # Version 0 API types
│   └── model/               # Data models for server.json
├── scripts/                 # Development and testing scripts
├── tests/                   # Integration tests
└── tools/                   # CLI tools and utilities
    └── validate-*.sh        # Schema validation tools

身份验证

发布支持多种身份验证方式：

• GitHub OAuth - 登录 GitHub 后发布
• GitHub OIDC - 从 GitHub Actions 发布
• DNS 验证 - 证明对某个域名及其子域名的所有权
• HTTP 验证 - 证明对某个域名的所有权

注册表会在发布时验证命名空间所有权。例如，若要发布……：

• io.github.domdomegg/my-cool-mcp，你必须以 domdomegg 身份登录 GitHub，或在 domdomegg 的代码库中运行 GitHub Action
• me.adamjones/my-cool-mcp，你必须通过 DNS 或 HTTP 验证证明对 adamjones.me 的所有权

社区项目

查看社区项目，了解社区创建的知名注册表相关项目。

更多文档

如果这里没有解答你的问题，请参阅文档了解更多详情！