项目简介

这是一个基于 Model Context Protocol (MCP) 的服务器实现，专注于集成GitHub Actions。它通过MCP工具向AI助手或其他MCP客户端暴露功能，特别是帮助分析GitHub Actions工作流的失败原因。

主要功能点

本项目提供了一个核心工具，用于：

• 获取最新失败日志: 自动查找指定GitHub仓库中最近一次失败的工作流运行。
• 提取错误信息: 从失败的工作流日志中智能地识别和提取关键错误消息，帮助快速定位问题。

这个服务器使得AI助手能够直接与GitHub Actions数据交互，辅助开发者进行故障排除和调试。

安装步骤

本项目通常通过'npx'命令直接运行，无需手动安装。确保你的系统已安装 Node.js。

服务器配置 (供 MCP 客户端使用)

MCP客户端需要配置如何启动并连接到此服务器。以下是典型的JSON配置格式，您需要将其添加到您的MCP客户端的配置中：

{
  "mcpServers": {
    "github-actions-mcp": {
      "command": "npx", // 启动服务器的命令
      "args": ["-y", "github-actions-mcp"], // 传递给命令的参数，-y 允许 npx 自动安装
      "env": {
        "GITHUB_TOKEN": "your_github_personal_access_token_with_repo_read_access" // 必需：用于访问GitHub API的个人访问令牌，需要仓库读取权限
      }
    }
  }
}

请将 '"your_github_personal_access_token_with_repo_read_access"' 替换为您自己的GitHub个人访问令牌。

基本使用方法

配置完成后，您的MCP客户端（例如AI助手）就可以通过调用服务器提供的工具来与GitHub Actions交互。

客户端会调用名为 'get_latest_failed_run_logs' 的工具，并传入两个参数：

• 'owner': GitHub仓库的所有者（用户名或组织名）。
• 'repo': GitHub仓库的名称。

服务器接收到请求后，会调用GitHub API获取数据，处理后将提取到的错误信息通过MCP协议返回给客户端。