GitHub-Vercel MCP 服务器

GitHub 仓库自动创建和 Vercel 模板部署的自动化 MCP 服务。

功能特性

• 🚀 自动检测：从令牌中自动识别 GitHub 命名空间
• 🤖 团队感知：支持团队层面的 Vercel 操作
• ⚡ 零配置：大多数用例下无需额外配置
• 🔒 安全：妥善处理凭证信息

本地安装

npm install -g @yourpackage/mcp-server-github

MCP 配置

在你的 mcp.config.json 中添加：

{
  "mcpServers": {
        "vercel-github": {
          "command": "npx",
          "args": [
            "mcp-vercel-github-integration",
            "-v",
            "<Your Vercel API Key>",
            "-g",
            "<Your Git API Key>"
          ]
    }
  }
}

必要权限

GitHub Token

repo:       # 全局仓库控制权限
user:       # 读取用户配置资料
read:org    # 如果使用组织功能

Vercel Token

• projects:read 和 projects:write
• teams:read（如果使用团队）

使用方法

基本部署

mcp execute github --REPO_NAME "my-app" --TEMPLATE_SOURCE "https://github.com/vercel/vercel/tree/main/examples/nextjs"

所有参数

API 响应

成功执行返回：

{
  "status": "success",
  "data": {
    "githubRepo": "https://github.com/yourname/repo",
    "vercelProject": "https://repo.vercel.app",
    "projectId": "prj_abc123"
  }
}

错误处理

常见错误响应包括：

{
  "status": "error",
  "error": {
    "code": "GITHUB_AUTH_FAILED",
    "message": "无效的 GitHub 令牌"
  }
}

开发

1. 克隆仓库
2. 安装依赖项：

   npm install
   

3. 配置环境：

   cp .env.example .env
   

4. 执行测试：

   npm test
   

发布

将包打包并发布到 npm：

npm publish --access public

许可证

MIT