简介

刚刚发布的MCP Registry 1.1带来了重大更新，但其中暗藏着一个"版本陷阱"让我调试了好几天！作为第一时间尝鲜的开发者，我将分享完整的CI/CD自动化部署方案，让你10分钟就能上手。文中包含可直接复用的代码模板和避坑指南，让我们一起在AI智能体生态中抢占先机！

正文

大家好！我是Sam，今天想和大家分享一个令人兴奋的消息：MCP Registry 1.1 刚刚发布（大约10小时前）！ 作为一直关注Model Context Protocol发展的技术爱好者，我立即进行了尝鲜测试，并成功将我们的i18n多语言智能体项目部署到了官方Registry。

🚀 为什么要关注MCP Registry？

对于正在构建AI应用的开发者来说，MCP（Model Context Protocol）正在成为连接不同AI模型和工具的重要标准。而Registry的更新意味着：

• 标准化部署：像Docker Hub一样，为AI智能体提供统一的发布平台
• 生态互联：让你的项目能够轻松集成到Claude、GPT等主流AI平台
• 自动化流程：通过CI/CD实现持续部署，提升开发效率

💡 我遇到的"版本陷阱"与解决方案

在测试过程中，我发现MCP Registry 1.1.0与1.0.0版本存在不兼容的breaking change，这让我花了几天时间调试。具体来说：

• Schema定义发生了变更，旧配置无法直接使用
• 认证流程有所优化，需要调整发布脚本
• 运行时参数配置更加规范化

但别担心，我已经帮你踩完了所有的坑！下面是经过验证的完整解决方案。

🛠️ 可复用的CI/CD自动化部署模板

以下是完整的GitHub Actions配置，你可以直接复制使用：

name: Publish to MCP Registry

on:
  push:
    tags: ['v*']

jobs:
  publish:
    runs-on: ubuntu-latest
    strategy:
      matrix:
        service: ['mcp']
        include:
          - service: mcp
            tags: |
              ghcr.io/samyuan1990/i18n-agent-action:mcp,
              ghcr.io/samyuan1990/i18n-agent-action:latest-mcp
            labels: |
              mcp=latest-mcp
              io.modelcontextprotocol.server.name=io.github.SamYuan1990/i18n-agent-action
            build_args: SERVICE_TYPE=mcp

    steps:
    - name: Checkout code
      uses: actions/checkout@v4

    # 构建多平台Docker镜像
    - name: Build and push Docker image
      uses: docker/build-push-action@v6
      with:
        context: .
        platforms: linux/amd64,linux/arm64
        push: true
        tags: ${{ matrix.tags }}
        labels: ${{ matrix.labels }}
        file: ./Dockerfile
        build-args: ${{ matrix.build_args }}

    # 安装MCP发布工具（关键步骤！）
    - name: Install MCP Publisher
      run: |
        curl -L "https://github.com/modelcontextprotocol/registry/releases/download/v1.1.0/mcp-publisher_1.1.0_$(uname -s | tr '[:upper:]' '[:lower:]')_$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/').tar.gz" | tar xz mcp-publisher

    # 使用GitHub OIDC登录（更安全的方式）
    - name: Login to MCP Registry
      run: ./mcp-publisher login github-oidc

    # 发布到MCP Registry
    - name: Publish to MCP Registry
      run: |
        ./mcp-publisher publish

📋 核心配置文件解析

关键的server.json配置文件，我已经针对1.1版本进行了优化：

{
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-09-16/server.schema.json",
  "name": "io.github.SamYuan1990/i18n-agent-action",
  "description": "智能多语言翻译GitHub Action，支持实时国际化处理",
  "version": "mcp",
  "packages": [
    {
      "registryType": "oci",
      "registryBaseUrl": "https://ghcr.io",
      "identifier": "SamYuan1990/i18n-agent-action",
      "version": "mcp",
      "runtimeHint": "docker",
      "transport": {
        "type": "sse",
        "URL": "https://example.com:8080/sse"
      },
      "runtimeArguments": [
        {
          "type": "named",
          "name": "-p",
          "value": "8080:8080",
          "description": "容器端口映射配置"
        },
        {
          "type": "named",
          "name": "-e",
          "value": "api_key={api_key}",
          "description": "翻译服务API密钥",
          "variables": {
            "api_key": {
              "description": "用于翻译服务的API密钥",
              "isRequired": true,
              "isSecret": true,
              "format": "string"
            }
          }
        }
        // 更多配置参数...
      ]
    }
  ]
}

🌟 我们的技术实践与创新

基于在MCP领域的深度实践，我们还向社区贡献了：

1. 多模态MCP解决方案：参与社区讨论
2. Registry优化建议：提交的Issue反馈

这些贡献体现了我们对AI基础设施建设的持续投入和技术前瞻性。

🎯 立即行动的建议

如果你也想快速上手MCP Registry 1.1：

1. 直接复制上面的CI/CD配置到你的项目
2. 调整server.json中的项目信息
3. 关注版本兼容性问题，避免重蹈我的覆辙
4. 参与社区讨论，共同推动标准发展

💬 让我们一起成长

技术在快速迭代，没有人能掌握所有答案。我在这个过程中也遇到了很多挑战，但正是通过社区交流和持续实践，我们才能共同进步。如果你在部署过程中遇到任何问题，欢迎在评论区交流，或者到我们的项目主页了解更多细节。

技术的价值在于分享，生态的繁荣源于共建。 期待在AI智能体的大潮中，与各位开发者朋友一起探索更多可能性！