GitHub CI/CD MCP Server

github-cicd-mcp

用于 Model Context Protocol 的 GitHub CI/CD MCP 服务。

面向 GitHub REST 和 GraphQL 的模型上下文协议（MCP）服务，专为 Cursor、Claude Desktop 和其他 MCP 客户端中的 CI/CD 和 DevOps 工作流打造。

为你的 AI Agent 提供管理仓库、提交、拉取请求、议题、GitHub Actions、部署、账单、发布、分支保护、webhook 和本地 git 的工具，无需离开编辑器。

---

安装

npm / npx（推荐）

{
  "mcpServers": {
    "github-cicd": {
      "command": "npx",
      "args": ["-y", "@kinus/github-cicd-mcp"],
      "env": {
        "GITHUB_TOKEN": "${env:GITHUB_TOKEN}"
      }
    }
  }
}

在系统环境中设置 GITHUB_TOKEN（或 GH_TOKEN），或将 ${env:GITHUB_TOKEN} 替换为客户端支持的密钥引用。

从源代码安装

git clone https://github.com/devstephenke-sys/Github-Free-MCPs.git
cd Github-Free-MCPs
npm install
npm run build

将 MCP 指向 node /absolute/path/to/github-cicd-mcp/dist/index.js。

---

身份验证

创建个人访问令牌：

需求	范围／权限
仓库、PR、提交、议题	repo 或细粒度的 Contents、Pull requests、Issues
Actions	workflow
组织账单	read:org + 组织账单角色
管理员（分支保护、webhook）	仓库／组织的管理员访问权限

切勿提交令牌。仅使用环境变量。

⚠️ 安全性：请参阅 SECURITY.md，了解安全政策和最佳实践。

近期安全更新（v1.2.3）：将 simple-git 更新至 v4.0.2，以修复严重安全漏洞（CVE-2026-102828、CVE-2026-102826、CVE-2026-102827、CVE-2026-6951）。

---

工具参考

核心与仓库

github_get_authenticated_user、github_get_rate_limit、github_create_repository、github_get_repository、github_list_repositories、github_create_branch、github_fork_repository

提交与 CI 状态

github_list_commits、github_get_commit、github_compare_commits、github_create_commit、github_get_combined_status、github_list_check_runs_for_ref

拉取请求

github_create_pull_request、github_list_pull_requests、github_get_pull_request、github_merge_pull_request、github_update_pull_request、github_list_pull_request_files、github_create_pull_request_review

议题

github_create_issue、github_list_issues、github_get_issue、github_update_issue、github_add_issue_comment、github_list_issue_comments

发布与标签

github_list_releases、github_get_release_by_tag、github_create_release、github_list_tags、github_create_tag

分支与保护

github_list_branches、github_get_branch、github_get_branch_protection、github_update_branch_protection、github_delete_branch_protection

GitHub Actions

github_list_workflows、github_list_workflow_runs、github_get_workflow_run、github_list_workflow_jobs、github_rerun_workflow、github_cancel_workflow_run、github_dispatch_workflow、github_list_actions_secrets、github_list_actions_variables、github_list_workflow_run_artifacts、github_download_workflow_artifact

部署（CD）

github_list_deployments、github_create_deployment、github_create_deployment_status、github_list_environments

账单

github_get_user_billing_actions、github_get_org_billing_actions、github_get_org_billing_overview、github_get_org_billing_usage_report

Webhook 与访问

github_list_webhooks、github_create_webhook、github_delete_webhook、github_list_collaborators、github_add_collaborator、github_list_teams

GraphQL

github_graphql_query、github_graphql_mutation、github_graphql_repository_overview

本地 git

git_status、git_commit、git_push、git_pull、git_log、git_clone

---

GitHub Enterprise

• GITHUB_HOST — 主机名（不是 github.com 时）
• GITHUB_API_URL — REST 基础 URL，例如 https://github.example.com/api/v3
• GITHUB_GRAPHQL_URL — GraphQL 端点覆盖项

---

开发

npm install
npm run build
npm run verify

---

发布你自己的分支

参见 RELEASING.md，了解：

• 公共 GitHub 仓库设置
• npm 发布（npm publish --access public）
• GitHub Releases 和可选的 MCP 目录列表

---

许可证

MIT