Gei Migration MCP

GEI迁移MCP服务器

一个模型上下文协议（MCP）服务器，封装了GitHub Enterprise Importer（GEI）API，支持自然语言驱动的存储库迁移。

特性

• GitHub→ GitHub 迁移
• Azure DevOps→ GitHub 迁移
• 通过MCP的自然语言界面
• 库存和发现工具
• 迁移跟踪和历史
• 本地（stdio） 和 远程（HTTP+SSE） 运输支援
• Azure容器应用 部署就绪

快速入门（托管服务器）

MCP服务器已部署并准备就绪，无需安装。只需将其添加到您的VS代码设置中。

1.打开MCP设置

在VS Code中，按 Ctrl+Shift+P → 首选项：打开MCP配置 （或编辑您的 mcp.json 直接）。

2.添加服务器

将以下内容合并到您的 mcp.json:

{
  "servers": {
    "gei-migration": {
      "type": "sse",
      "url": "https://gei-migration-mcp.proudgrass-ef996862.eastus.azurecontainerapps.io/sse",
      "headers": {
        "X-GitHub-Source-PAT": "${input:gei_github_token}",
        "X-GitHub-Target-PAT": "${input:gei_target_pat}",
        "X-ADO-PAT": "${input:gei_ado_pat}"
      }
    }
  },
  "inputs": [
    {
      "id": "gei_github_token",
      "type": "promptString",
      "description": "GitHub PAT for source org (needs repo, read:org scopes)",
      "password": true
    },
    {
      "id": "gei_target_pat",
      "type": "promptString",
      "description": "GitHub PAT for target org (needs admin:org, repo, workflow scopes)",
      "password": true
    },
    {
      "id": "gei_ado_pat",
      "type": "promptString",
      "description": "Azure DevOps PAT (optional — press Enter to skip if not doing ADO migrations)",
      "password": true
    }
  ]
}

3.创建您的PAT

注： 当服务器连接时，VS Code将提示您输入PAT。它们通过HTTP标头按会话发送，从不存储在服务器上。

4.开始使用

在代理模式下打开Copilot Chat，然后尝试：

@gei-migration list repos in github org my-source-org
@gei-migration migrate repo my-repo from my-source-org to my-target-org
@gei-migration check migration status

______________________________________________________________________

可用工具

本地设置（stdio）

1. 安装依赖项：

   npm install

1. 构建：

   npm run build

1. 添加到VS代码 mcp.json:

   {
     "servers": {
       "gei-migration": {
         "type": "stdio",
         "command": "node",
         "args": ["path/to/gei-migration-mcp/dist/index.js"],
         "env": {
           "GITHUB_TOKEN": "your-source-pat",
           "GH_PAT": "your-target-pat",
           "ADO_PAT": "your-ado-pat"
         }
       }
     }
   }

远程设置（HTTP+SSE）

使用HTTP在本地运行

npm run build
MCP_TRANSPORT=http PORT=3000 npm start

码头工人

docker build -t gei-migration-mcp .
docker run -p 3000:3000 gei-migration-mcp

部署到Azure容器应用程序

# Create resource group
az group create -n gei-migration-rg -l eastus

# Deploy with Bicep (no secrets needed - users provide their own)
az deployment group create \
  -g gei-migration-rg \
  -f infra/main.bicep

将MCP客户端连接到远程服务器

推荐：HTTP标头（安全）

使用带有VS Code输入提示的HTTP标头进行安全凭据处理：

{
  "servers": {
    "gei-migration": {
      "type": "sse",
      "url": "https://your-app.azurecontainerapps.io/sse",
      "headers": {
        "X-GitHub-Source-PAT": "${input:ghSourcePat}",
        "X-GitHub-Target-PAT": "${input:ghTargetPat}",
        "X-ADO-PAT": "${input:adoPat}"
      }
    }
  },
  "inputs": [
    { "id": "ghSourcePat", "type": "promptString", "description": "GitHub PAT for source org", "password": true },
    { "id": "ghTargetPat", "type": "promptString", "description": "GitHub PAT for target org", "password": true },
    { "id": "adoPat", "type": "promptString", "description": "Azure DevOps PAT (optional, press Enter to skip)", "password": true }
  ]
}

这种方法：

• 运行时提示输入凭据（不存储在配置文件中）
• 通过HTTP标头发送凭据（未登录URL）
• 屏蔽输入 password: true

备选方案：查询参数

为了快速测试，凭据也可以作为查询参数传递：

{
  "servers": {
    "gei-migration": {
      "type": "sse",
      "url": "https://your-app.azurecontainerapps.io/sse?gh_source_pat=YOUR_SOURCE_PAT&gh_pat=YOUR_TARGET_PAT"
    }
  }
}

⚠️ 警告：查询参数可能会出现在日志和浏览器历史记录中。使用标头进行生产。

标题/查询参数：

多租户支持

服务器支持多个并发用户，每个用户都有自己的凭据：

• 每个SSE连接都会创建一个隔离的会话
• 凭据按会话存储，从不共享
• 连接关闭时，会话会自动清理
• 服务器上没有存储凭据-用户提供自己的凭据

使用示例

@gei-migration check prerequisites
@gei-migration inventory github org my-source-org
@gei-migration migrate repo my-repo to target org my-target-org
@gei-migration list active migrations

环境变量（本地/stdio模式）

需要PAT范围

• 来源PAT: repo, read:org, workflow
• 目标PAT: admin:org, repo, workflow
• 阿多·帕特：完全访问或 Code (Read)

建筑

┌─────────────────────────────────────────────────────────────┐
│  MCP Client (VS Code, Claude Desktop, etc.)                 │
└─────────────────────┬───────────────────────────────────────┘
                      │ MCP Protocol (stdio or HTTP+SSE)
                      ▼
┌─────────────────────────────────────────────────────────────┐
│  GEI Migration MCP Server                                   │
│  ├── Tools (migrate, inventory, status, etc.)               │
│  ├── Resources (active migrations, history)                 │
│  └── Prompts (migration planning templates)                 │
└─────────────────────┬───────────────────────────────────────┘
                      │ GraphQL / REST APIs
                      ▼
┌─────────────────────────────────────────────────────────────┐
│  GitHub API          │  Azure DevOps API                    │
│  (GraphQL)           │  (REST)                              │
└─────────────────────────────────────────────────────────────┘

许可证

麻省理工学院