Personal-MCP

MCP Registry

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

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

开发状态

2025-10-24 更新：Registry 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

发布服务器

我们构建了一个简单的命令行工具来发布服务器。你可以这样使用它：

# 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

社区项目

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

更多文档

如果这里没有解答你的问题，请参阅文档了解详情！ mcp-name: io.github.arun250492/personal-mcp