remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Provides access to GitHub repository data, allowing interaction with repositories to manage GitHub Actions workflows and analyze their execution.
Enables complete workflow management including listing, viewing, triggering, canceling, and rerunning workflows, as well as analyzing workflow runs and their jobs in GitHub repositories.

GitHub Actions MCP 服务器

GitHub Actions API 的 MCP 服务器，使 AI 助手能够管理和操作 GitHub Actions 工作流程。

特征

完整的工作流管理：列出、查看、触发、取消和重新运行工作流
工作流运行分析：获取有关工作流运行及其作业的详细信息
全面的错误处理：清晰的错误信息，增强详细信息
灵活的类型验证：强大的类型检查，优雅地处理 API 变化
以安全为中心的设计：超时处理、速率限制和严格的 URL 验证

工具

list_workflows
- 列出 GitHub 存储库中的工作流程
- 输入：
  - owner （字符串）：存储库所有者（用户名或组织）
  - repo （字符串）：存储库名称
  - page （可选数字）：分页的页码
  - perPage （可选数字）：每页结果数（最多 100 条）
- 返回：存储库中的工作流列表
get_workflow
- 获取特定工作流的详细信息
- 输入：
  - owner （字符串）：存储库所有者（用户名或组织）
  - repo （字符串）：存储库名称
  - workflowId （字符串或数字）：工作流程或文件名的 ID
- 返回：有关工作流程的详细信息
get_workflow_usage
- 获取工作流的使用情况统计信息
- 输入：
  - owner （字符串）：存储库所有者（用户名或组织）
  - repo （字符串）：存储库名称
  - workflowId （字符串或数字）：工作流程或文件名的 ID
- 返回：使用情况统计数据，包括计费分钟数
list_workflow_runs
- 列出存储库或特定工作流程的所有工作流程运行
- 输入：
  - owner （字符串）：存储库所有者（用户名或组织）
  - repo （字符串）：存储库名称
  - workflowId （可选字符串或数字）：工作流程或文件名的 ID
  - actor （可选字符串）：按触发工作流程的用户进行过滤
  - branch （可选字符串）：按分支过滤
  - event （可选字符串）：按事件类型过滤
  - status （可选字符串）：按状态过滤
  - created （可选字符串）：按创建日期过滤（YYYY-MM-DD）
  - excludePullRequests （可选布尔值）：排除 PR 触发的运行
  - checkSuiteId （可选数字）：按检查套件 ID 进行过滤
  - page （可选数字）：分页的页码
  - perPage （可选数字）：每页结果数（最多 100 条）
- 返回：符合条件的工作流运行列表
get_workflow_run
- 获取特定工作流程运行的详细信息
- 输入：
  - owner （字符串）：存储库所有者（用户名或组织）
  - repo （字符串）：存储库名称
  - runId （数字）：工作流程运行的 ID
- 返回：有关特定工作流程运行的详细信息
get_workflow_run_jobs
- 获取特定工作流程运行的作业
- 输入：
  - owner （字符串）：存储库所有者（用户名或组织）
  - repo （字符串）：存储库名称
  - runId （数字）：工作流程运行的 ID
  - filter （可选字符串）：按完成状态过滤作业（‘最新’，‘全部’）
  - page （可选数字）：分页的页码
  - perPage （可选数字）：每页结果数（最多 100 条）
- 返回：工作流程运行中的作业列表
trigger_workflow
- 触发工作流程运行
- 输入：
  - owner （字符串）：存储库所有者（用户名或组织）
  - repo （字符串）：存储库名称
  - workflowId （字符串或数字）：工作流程或文件名的 ID
  - ref （字符串）：运行工作流的引用（分支、标签或 SHA）
  - inputs （可选对象）：工作流的输入参数
- 返回：有关触发的工作流程运行的信息
cancel_workflow_run
- 取消工作流程运行
- 输入：
  - owner （字符串）：存储库所有者（用户名或组织）
  - repo （字符串）：存储库名称
  - runId （数字）：工作流程运行的 ID
- 返回：取消操作的状态
rerun_workflow
- 重新运行工作流程
- 输入：
  - owner （字符串）：存储库所有者（用户名或组织）
  - repo （字符串）：存储库名称
  - runId （数字）：工作流程运行的 ID
- 返回：重新运行操作的状态

与 Claude Desktop 一起使用

首先，确保你已经构建了项目（参见下面的“构建”部分）。然后，将以下内容添加到你的claude_desktop_config.json中：

{
  "mcpServers": {
    "github-actions": {
      "command": "node",
      "args": [
        "<path-to-mcp-server>/dist/index.js"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>"
      }
    }
  }
}

建造

克隆存储库并构建：

git clone https://github.com/ko1ynnky/github-actions-mcp-server.git
cd github-actions-mcp-server
npm install
npm run build

这将在dist目录中创建运行 MCP 服务器所需的必要文件。

使用示例

列出存储库中的工作流程：

const result = await listWorkflows({
  owner: "your-username",
  repo: "your-repository"
});

触发工作流程：

const result = await triggerWorkflow({
  owner: "your-username",
  repo: "your-repository",
  workflowId: "ci.yml",
  ref: "main",
  inputs: {
    environment: "production"
  }
});

故障排除

常见问题

身份验证错误：
- 确保您的 GitHub 令牌具有正确的权限
- 检查令牌是否正确设置为环境变量
速率限制：
- 服务器实施速率限制以避免达到 GitHub API 限制
- 如果遇到速率限制错误，请降低请求频率
类型验证错误：
- GitHub API 响应有时可能与预期模式不同
- 服务器实现灵活的验证来处理大多数变化
- 如果您遇到持续性错误，请打开一个问题

执照

此 MCP 服务器根据 MIT 许可证获得许可。

You must be authenticated.

A

security – no known vulnerabilities

F

license - not found

A

quality - confirmed to work

Tools

View all tools

MCP 服务器通过 GitHub API 提供列出、查看、触发、取消和重新运行工作流的工具，使 AI 助手能够管理 GitHub Actions 工作流。

Appeared in Searches

Using MCP server to manage GitHub Actions