GitHub-Vercel MCP 服务器

自动化创建 GitHub 仓库并部署 Vercel 模板，作为一个 MCP 服务。

特性

• 🚀 自动检测来自 Token 的 GitHub 命名空间
• 🤖 团队感知的 Vercel 操作
• ⚡ 零配置适用于大多数用例
• 🔒 安全的凭据处理

本地安装

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

MCP 配置

添加到你的 mcp.config.json：

{
  "mcpServers": {
        "vercel-github": {
          "command": "npx",
          "args": [
            "mcp-vercel-github-integration",
            "-v",
            "<你的 Vercel API 密钥>",
            "-g",
            "<你的 Git API 密钥>"
          ]
    }
  }
}

必需权限

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"

所有参数

参数	默认值	描述
VERCEL_API_KEY	-	(必需) Vercel API 密钥
GITHUB_TOKEN	-	(必需) GitHub 个人访问令牌
REPO_NAME	"new-repo"	仓库名称
TEMPLATE_SOURCE	Vercel Next.js	模板 Git URL
IS_PRIVATE	true	将仓库设为私有

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 token"
  }
}

开发

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

   npm install
   

3. 设置环境：

   cp .env.example .env
   

4. 运行测试：

   npm test
   

部署

打包并发布到 npm：

npm publish --access public

许可证

MIT