Mcp Server Github Actions

mcp-server-github-actions

通过 AI 助手管理 GitHub Actions 工作流。列出运行记录、读取日志、重新运行失败的作业、取消构建并触发部署，无需离开编辑器。

npx mcp-server-github-actions

兼容 Claude Desktop、Cursor、VS Code Copilot 及任何 MCP 客户端。需要具有 Actions 权限的 GitHub 令牌。

_{演示使用 remotion-readme-kit 构建}

为什么

GitHub 官方 MCP 服务支持仓库、议题和 PR，但不支持 Actions。这意味着 CI 失败时，你仍然必须打开浏览器、找到运行记录、点击查看日志，然后弄清楚出了什么问题。这个服务填补了这一空白。你可以直接在当前工作环境中询问助手“上次 CI 运行为什么失败？”或“重新运行失败的作业”，并获得答案。它使用的就是你手动操作时会用到的 GitHub REST API，只是免去了切换上下文的麻烦。

工具

工具	描述
list_workflows	列出仓库中的所有工作流文件
list_runs	列出工作流运行记录（可按工作流或状态筛选）
get_run	获取特定工作流运行记录的详细信息
get_run_logs	获取运行记录的日志 URL（ZIP 文件下载）
rerun_workflow	重新运行整个工作流
rerun_failed_jobs	仅重新运行运行记录中失败的作业
cancel_run	取消正在进行或排队中的运行记录
list_artifacts	列出工作流运行记录生成的构件
trigger_workflow	通过 workflow_dispatch 触发工作流

快速开始

Cursor

添加到 Cursor MCP 设置中（例如 ~/.cursor/mcp.json 或项目级设置）：

{
  "mcpServers": {
    "github-actions": {
      "command": "npx",
      "args": ["-y", "mcp-server-github-actions"],
      "env": {
        "GITHUB_TOKEN": "<your-token>"
      }
    }
  }
}

Claude Desktop

添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "github-actions": {
      "command": "npx",
      "args": ["-y", "mcp-server-github-actions"],
      "env": {
        "GITHUB_TOKEN": "<your-token>"
      }
    }
  }
}

VS Code

添加到用户设置或 .vscode/mcp.json：

{
  "mcp": {
    "servers": {
      "github-actions": {
        "command": "npx",
        "args": ["-y", "mcp-server-github-actions"],
        "env": {
          "GITHUB_TOKEN": "<your-token>"
        }
      }
    }
  }
}

身份验证

创建 GitHub Personal Access Token：

1. Settings > Developer settings > Personal access tokens
2. 选择 Fine-grained tokens（推荐）或 Tokens (classic)
3. 细粒度令牌：选择仓库，然后启用 Actions: Read and Write
4. 经典令牌：启用 repo 作用域（包含 Actions）

Agent Plugins

此仓库是一个 Agent Plugins 1.0.0 软件包：plugin.json、可移植的 mcp.json 和 skills/ 与 MCP 服务一同发布。

对于 Cursor，克隆仓库并将其复制或符号链接到 ~/.cursor/plugins/local/mcp-server-github-actions，然后重新加载窗口。技能和 MCP 服务会显示在 Customize > Plugins 下。

Agent Plugins v1 不提供 OAuth。请在 MCP 客户端配置中设置 GITHUB_TOKEN（参见“快速开始”）。由于令牌必须保留在环境变量中，因此不提供 Cursor/VS Code 一键安装。

常见问题

什么是 mcp-server-github-actions？

一个用于 GitHub Actions 的 MCP 服务：列出运行记录、获取运行详情、重新运行失败的任务、取消运行、列出构建产物，以及触发 workflow_dispatch。

我需要什么令牌？

需要一个 GitHub PAT，且对你管理的仓库具有 Actions 读写权限。在 MCP 服务环境配置块中设置 GITHUB_TOKEN。

这与官方 GitHub MCP 有什么不同？

官方服务涵盖仓库、议题和 PR。这个服务专注于工作流运行、日志 URL、重新运行和分发触发。

我可以在 Cursor 中将其安装为 Agent 插件吗？

可以，通过 ~/.cursor/plugins/local/mcp-server-github-actions 安装。你仍需在 Cursor MCP 设置中配置 GITHUB_TOKEN。

为什么没有一键安装按钮？

令牌无法安全地嵌入便携式安装链接中。请使用 Quick Start 下方的 JSON 代码片段。

示例提示词

• “列出 ofershap/mcp-server-docker 最近 5 次工作流运行”
• “显示 microsoft/vscode 仓库中的工作流”
• “获取 owner/repo 中运行记录 12345 的详情”
• “重新运行 my-org/my-repo 中运行记录 67890 的失败任务”
• “取消当前正在运行的工作流运行记录 11111”
• “列出 owner/repo 最近一次运行的构建产物”
• “在 my-org/my-app 的 staging 分支上触发 deploy.yml 工作流”
• “这个项目最近一次 CI 运行的状态是什么？”

开发

npm install
npm run typecheck
npm run build
npm test
npm run lint
npm run format

另请参阅

在我的作品集中查看更多 MCP 服务和开发者工具。

作者

---

_{此 README 使用 README Builder 构建}

许可证

MIT © 2026 Ofer Shapira