Copilot Agent MCP Registry

Azure API中心的MCP服务器注册

使用基于Git的工作流（Pull Request）、Copilot SDK和Azure API中心集成的自动MCP（模型上下文协议）服务器注册系统。

🎯 概述

此存储库充当组织内MCP服务器的集中注册表。它提供：

• 📝 基于Git的注册：通过Pull Request提交MCP服务器以供审查和批准
• 🤖 Copilot SDK助手：交互式CLI工具，指导您完成注册过程
• ☁️ Azure API中心集成：PR合并后自动注册到Azure API中心
• 📚 自托管门户：通过Azure API中心门户浏览和发现MCP服务器
• ✅ 治理：具有审计跟踪的内置审批工作流

🏗️ 建筑

┌─────────────────┐
│  Developer      │
│  (CLI Tool)     │
└────────┬────────┘
         │ 1. Input metadata
         │ 2. Generate files
         │ 3. Create PR
         ▼
┌─────────────────────────┐
│  GitHub Repository      │
│  ├── apis/              │
│  │   └── /    │
│  │       ├── openapi.json
│  │       ├── metadata.json
│  │       └── README.md   │
│  └── .github/workflows/ │
└────────┬────────────────┘
         │ 4. PR Merge
         │ 5. GitHub Actions
         ▼
┌─────────────────────────┐
│  Azure API Center       │
│  (System of Record)     │
└────────┬────────────────┘
         │ 6. Portal Access
         ▼
┌─────────────────────────┐
│  API Center Portal      │
│  (Self-hosted)          │
└─────────────────────────┘

🚀 快速开始

先决条件

• .NET 10.0 SDK或更高版本
• Git
• 访问此存储库
• （用于部署）带有API中心实例的Azure订阅

安装

1. 克隆存储库：

git clone https://github.com/tatatatamami/copilot-agent-mcp-registry.git
cd copilot-agent-mcp-registry

1. 构建CLI工具：

dotnet build

注册新的MCP服务器

1. 运行注册助手：

dotnet run --project src/McpRegistration.Cli

1. 按照交互式提示提供：

- MCP服务器名称（小写，仅限连字符） - 描述 - 版本（语义版本控制） - 公司/组织 - 所有者（个人或团队名称） - 联系邮箱 - 状态（活动、已弃用、计划） - 生命周期（设计、开发、测试、预览、生产、弃用、退役） - 身份验证方法（无、api密钥、oauth2、entra id） - 端点URL - 文档URL - 标签

1. 该工具将：

- ✅ 验证您的输入 - ✅ 在中生成所需文件 apis// - ✅ 创建一个新的Git分支 - ✅ 提交更改

1. 推送分支并创建Pull Request：

git push -u origin mcp-registration/

1. 使用提供的模板在GitHub上创建PR

1. 在批准和合并后，GitHub Actions将自动将您的MCP注册到Azure API中心

📁 仓库结构

├── .github/
│   ├── workflows/
│   │   └── register-to-api-center.yml    # Automated registration workflow
│   └── PULL_REQUEST_TEMPLATE/
│       └── mcp-registration.md           # PR template for reviews
├── apis/
│   └── /                       # One directory per MCP server
│       ├── openapi.json                  # OpenAPI 3.0 specification
│       ├── metadata.json                 # Metadata for API Center
│       └── README.md                     # Documentation
├── catalog/
│   └── index.yaml                        # Optional: catalog index
├── src/
│   ├── McpRegistration.Cli/              # Interactive CLI tool
│   └── McpRegistration.Core/             # Core libraries
│       ├── Models/                       # Data models
│       └── Services/                     # Business logic
└── README.md                             # This file

📋 元数据模式

每个MCP服务器都需要以下元数据：

必填字段

可选字段

🔐 身份验证方法

API密钥(api-key)

使用Bearer令牌的标准API密钥身份验证。适用于大多数内部服务。

OAuth 2.0(oauth2)

用于委派访问的OAuth 2.0流。需要用户授权时使用。

微软Entra ID(entra-id)

Entra ID（以前称为Azure AD）身份验证。建议用于具有现有Azure/Microsoft 365集成的企业场景。

没有(none)

无需身份验证。 仅用于开发/内部环境。

🔄 生命周期阶段

⚙️ GitHub操作设置

必需的秘密

在GitHub存储库设置中配置这些机密：

Azure安装程序

1. 创建Azure API中心实例：

az apic create \
  --resource-group  \
  --name  \
  --location 

1. 为GitHub操作创建服务主体：

az ad sp create-for-rbac \
  --name "GitHub-Actions-API-Center" \
  --role "API Management Service Contributor" \
  --scopes /subscriptions//resourceGroups/ \
  --sdk-auth

1. 为OIDC配置联合凭据（推荐）：

az ad app federated-credential create \
  --id  \
  --parameters credential.json

📊 自营API中心门户

要设置用于浏览已注册API的自托管门户：

1. 遵循Microsoft学习指南： 自助API中心门户

1. 配置门户以指向API中心实例

1. 部署到Azure应用服务或您首选的托管平台

该门户提供：

• 🔍 搜索和发现已注册的MCP
• 📖 API文档查看器
• 🏷️ 按元数据（公司、生命周期、标签）过滤
• 📋 OpenAPI规范查看器

🛠️ 发展

构建解决方案

dotnet build

运行测试（如果可用）

dotnet test

在本地运行CLI

cd src/McpRegistration.Cli
dotnet run

📚 参考文献

• Azure API中心文档
• API中心元数据
• 自助API中心门户
• MCP（模型上下文协议）规范

🤝 贡献

1. 创建要素分支
2. 进行更改
3. 提交拉取请求
4. 确保所有检查均已通过

对于MCP服务器注册，请使用CLI工具并遵循标准注册流程。

📄 许可证

此项目根据MIT许可证获得许可-有关详细信息，请参阅许可证文件。

🆘 支持

如有疑问或问题：

1. 检查现有文档
2. 搜索已关闭的问题
3. 创建具有详细描述的新问题
4. 联系平台团队

______________________________________________________________________

系统的记录：Azure API中心是所有注册MCP服务器的权威来源。此存储库用作注册接口和审计跟踪。