M

Maxteabag

@Maxteabag/GithubWorkflowMCP
Hosted
0 Stars 323 次浏览 Maxteabag 更新于 2026-08-23

MCP 服务配置

复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用

{
  "mcpServers": {
    "github": {
      "args": [
        "-y",
        "@modelcontextprotocol/server-github"
      ],
      "command": "npx",
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "\u003cYOUR_TOKEN\u003e"
      }
    }
  }
}

可用工具 (26 个)

该服务在 MCP 协议中暴露的工具,AI 可按需调用

create_or_update_file

Create or update a single file in a GitHub repository

该工具无需必填参数,直接调用即可

search_repositories

Search for GitHub repositories

该工具无需必填参数,直接调用即可

create_repository

Create a new GitHub repository in your account

该工具无需必填参数,直接调用即可

get_file_contents

Get the contents of a file or directory from a GitHub repository

该工具无需必填参数,直接调用即可

push_files

Push multiple files to a GitHub repository in a single commit

该工具无需必填参数,直接调用即可

create_issue

Create a new issue in a GitHub repository

该工具无需必填参数,直接调用即可

create_pull_request

Create a new pull request in a GitHub repository

该工具无需必填参数,直接调用即可

fork_repository

Fork a GitHub repository to your account or specified organization

该工具无需必填参数,直接调用即可

create_branch

Create a new branch in a GitHub repository

该工具无需必填参数,直接调用即可

list_commits

Get list of commits of a branch in a GitHub repository

该工具无需必填参数,直接调用即可

list_issues

List issues in a GitHub repository with filtering options

该工具无需必填参数,直接调用即可

update_issue

Update an existing issue in a GitHub repository

该工具无需必填参数,直接调用即可

add_issue_comment

Add a comment to an existing issue

该工具无需必填参数,直接调用即可

search_code

Search for code across GitHub repositories

该工具无需必填参数,直接调用即可

search_issues

Search for issues and pull requests across GitHub repositories

该工具无需必填参数,直接调用即可

search_users

Search for users on GitHub

该工具无需必填参数,直接调用即可

get_issue

Get details of a specific issue in a GitHub repository.

该工具无需必填参数,直接调用即可

get_pull_request

Get details of a specific pull request

该工具无需必填参数,直接调用即可

list_pull_requests

List and filter repository pull requests

该工具无需必填参数,直接调用即可

create_pull_request_review

Create a review on a pull request

该工具无需必填参数,直接调用即可

merge_pull_request

Merge a pull request

该工具无需必填参数,直接调用即可

get_pull_request_files

Get the list of files changed in a pull request

该工具无需必填参数,直接调用即可

get_pull_request_status

Get the combined status of all status checks for a pull request

该工具无需必填参数,直接调用即可

update_pull_request_branch

Update a pull request branch with the latest changes from the base branch

该工具无需必填参数,直接调用即可

get_pull_request_comments

Get the review comments on a pull request

该工具无需必填参数,直接调用即可

get_pull_request_reviews

Get the reviews on a pull request

该工具无需必填参数,直接调用即可

服务介绍

GitHub Workflow Debugger MCP

smithery badge

一个用于通过GitHub API诊断和修复GitHub Actions工作流失败的多选择提示(MCP)工具。

概述

此工具通过结构化的决策树帮助用户诊断和修复GitHub Actions工作流失败。它使用GitHub API来获取工作流运行信息,分析失败原因,并提供可操作的解决方案。

功能

  • 获取仓库最近失败的工作流运行
  • 分析工作流运行的任务和步骤
  • 识别常见的失败模式
  • 为常见问题建议具体的修复方案
  • 查看和更新工作流文件

安装

通过Smithery安装

要通过Smithery自动为Claude Desktop安装githubworkflowmcp:

bash
npx -y @smithery/cli install @Maxteabag/githubworkflowmcp --client claude

手动安装

bash

克隆仓库

git clone https://github.com/yourusername/github-workflow-debugger-mcp.git
cd github-workflow-debugger-mcp

安装依赖

npm install

构建项目

npm run build

为本地使用链接二进制文件

npm link

使用

GitHub Workflow Debugger MCP旨在与支持模型上下文协议(MCP)的AI助手一起使用。它提供了几个可用于诊断和修复GitHub Actions工作流失败的工具。

所需权限

要使用此工具,您需要一个具有以下权限的GitHub个人访问令牌(PAT):

  • repo - 对私有仓库的完全控制
  • workflow - 更新GitHub Action工作流

您必须将此令牌设置为名为GITHUB_PERSONAL_ACCESS_TOKEN的环境变量。

配置

当使用MCP兼容客户端时,您可以按如下方式配置此工具:

json
{
"mcpServers": {
"github": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-github"
],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>"
}
}
}
}

<YOUR_TOKEN>替换为您的GitHub个人访问令牌。

可用工具

  1. get-failed-workflow-runs - 获取仓库最近失败的工作流运行
  2. get-workflow-run-jobs - 获取特定工作流运行的任务
  3. get-workflow-file - 检索工作流文件的内容
  4. update-workflow-file - 使用修复更新工作流文件
  5. analyze-workflow-failure - 分析失败的工作流运行并建议修复方案

使用示例

这里是如何与AI助手一起使用GitHub Workflow Debugger MCP的一个例子:

  1. 首先,检查仓库“username/repo”最近失败的工作流运行:

    I need to check recent failed workflow runs for my repository "username/repo".

  2. 分析特定的失败运行:

    Can you analyze workflow run #123456 and suggest fixes?

  3. 查看工作流文件:

    Show me the content of the workflow file at .github/workflows/main.yml

  4. 使用建议的修复更新工作流文件:

    Update the workflow file with the suggested fixes.

开发

前提条件

  • Node.js 16或更高版本
  • npm 或 yarn

设置

bash

安装依赖

npm install

构建项目

npm run build

项目结构

  • src/index.ts - MCP服务器的主要入口点
  • build/ - 编译后的JavaScript文件

许可证

ISC

相关 MCP 服务