Avalanche MCP Vscode

🚀 MCP 注册表

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

| ⚡️ 实时 API 文档 | | 📖 完整文档

🚀 快速开始

开发状态

• 2025 年 10 月 24 日更新：注册表 API 已进入 API 冻结期（v0.1） 🎉。在接下来的一个月或更长时间内，API 将保持稳定，不会有重大变更，这使得集成商可以放心地实现支持。此冻结期适用于 v0.1 版本，同时 v0 版本的开发仍在继续。我们将利用这段时间在实际集成中验证 API，并收集反馈，以塑造面向大众的 v1 版本。感谢大家的贡献和耐心等待 —— 你们的参与是我们取得这一进展的关键！
• 2025 年 9 月 8 日更新：注册表已开启预览版 🎉（公告博客文章）。虽然系统现在更加稳定，但这仍然是一个预览版本，可能会出现重大变更或数据重置。后续将发布正式版（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

运行服务器

# 启动完整开发环境
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。

# 运行最新稳定版本
docker run -p 8080:8080 ghcr.io/modelcontextprotocol/registry:latest

# 运行主分支的最新版本（持续部署）
docker run -p 8080:8080 ghcr.io/modelcontextprotocol/registry:main

# 运行特定版本
docker run -p 8080:8080 ghcr.io/modelcontextprotocol/registry:v1.0.0

# 运行主分支的开发版本
docker run -p 8080:8080 ghcr.io/modelcontextprotocol/registry:main-20250906-abc123d

发布服务器

要发布服务器，我们构建了一个简单的 CLI 工具。您可以这样使用它：

# 构建最新的 CLI
make publisher

# 使用它！
./bin/mcp-publisher --help

更多详细信息请参阅 发布指南。

其他命令

# 运行代码检查、单元测试和集成测试
make check

还有一些其他有用的开发命令。运行 make help 了解更多信息，或查看 Makefile。

🔧 技术细节

项目结构

├── cmd/                     # 应用程序入口点
│   └── publisher/           # 服务器发布工具
├── data/                    # 初始化数据
├── deploy/                  # 部署配置（Pulumi）
├── docs/                    # 文档
├── internal/                # 私有应用代码
│   ├── api/                 # HTTP 处理程序和路由
│   ├── auth/                # 身份验证（GitHub OAuth、JWT、命名空间阻止）
│   ├── config/              # 配置管理
│   ├── database/            # 数据持久化（PostgreSQL）
│   ├── service/             # 业务逻辑
│   ├── telemetry/           # 指标和监控
│   └── validators/          # 输入验证
├── pkg/                     # 公共包
│   ├── api/                 # API 类型和结构
│   │   └── v0/              # 版本 0 的 API 类型
│   └── model/               # server.json 的数据模型
├── scripts/                 # 开发和测试脚本
├── tests/                   # 集成测试
└── tools/                   # CLI 工具和实用程序
    └── validate-*.sh        # 模式验证工具

身份验证

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

• 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 的所有权。

✨ 社区项目

查看 社区项目，探索社区创建的与注册表相关的杰出工作。

📚 详细文档

如果您的问题在此处未得到解答，请查看 文档 以获取更多详细信息！