Pcb MCP

🚀 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

這將在 localhost:8080 啟動註冊表，並使用 PostgreSQL 數據庫。數據庫使用臨時存儲，每次重啟容器時都會重置，確保開發和測試環境的乾淨狀態。

注意：註冊表使用 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 的所有權

👥 社區項目

查看 社區項目，探索社區創建的與註冊表相關的重要項目。

📚 詳細文檔

如果您的問題在此處未得到解答，請查看 文檔 獲取更多詳細信息！