MCP 服务器

GHAS MCP server (GitHub Advanced Security)

此服务器与 GitHub Advanced Security 集成，用于加载安全警报并将其引入您的上下文中。支持 Dependabot 安全警报、密钥扫描警报、代码安全警报。

README

ghas-mcp-server

用于调用 GHAS 获取 GitHub 仓库信息的 MCP 服务器。

目前支持以下工具：

list_dependabot_alerts: 列出仓库中所有的 Dependabot 告警
list_secret_scanning_alerts: 列出仓库中所有的密钥扫描告警
list_code_scanning_alerts: 列出仓库中所有的代码扫描告警

请确保为配置的 PAT 添加以下三个作用域（只读），并针对正确的组织！

在 VS Code 和 VS Code Insiders 中安装

使用按钮在您的 VS Code 或 VS Code Insiders 环境中安装服务器。在信任它之前，请务必阅读链接！这些链接指向 vscode.dev 和 insiders.vscode.dev，并包含安装服务器的说明。

VS Code 将允许您在任何操作发生之前查看配置：

VS Code 中的配置截图

示例配置

将以下配置添加到编辑器中的 MCP 配置中。

安全选项：使用已验证身份的 GitHub CLI

除了存储个人访问令牌（请参阅下一节）之外，您还可以使用已验证身份的 GitHub CLI。这将使用您在 GitHub CLI 中配置的凭据。当您安装了 GitHub CLI 并且已经过身份验证时，这非常有用。

要使用 GitHub CLI 进行身份验证，请按照以下步骤操作：

将 "GITHUB_PERSONAL_ACCESS_TOKEN_USE_GHCLI": "true" 添加到您的环境变量中。
确保您已安装 GitHub CLI 并通过运行 gh auth login 进行身份验证。

配置：

{
    "mcp": {
        "inputs": [
        ]
    },
    "servers": {
        "ghas-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "@rajbos/ghas-mcp-server"
            ],
            "env": {
                "GITHUB_PERSONAL_ACCESS_TOKEN_USE_GHCLI": "true"
            }
        }
    }
  }

使用个人访问令牌进行配置

对于 VS Code，它看起来像这样：

{
    "mcp": {
        "inputs": [
            {
                "id": "github_personal_access_token",
                "description": "GitHub 个人访问令牌",
                "type": "promptString",
                "password": true
            }
        ]
    },
    "servers": {
        "ghas-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "@rajbos/ghas-mcp-server"
            ],
            "env": {
                "GITHUB_PERSONAL_ACCESS_TOKEN": "${input:github_personal_access_token}"
            }
        }
    }
  }

结果

VS Code 内部输出的屏幕截图

贡献

欢迎贡献！如果您对新工具或改进有任何想法，请提出问题或提交拉取请求。

快速开始

# 安装依赖
npm install

# 构建项目
npm run build

项目结构

ghas-mcp-server/
├── src/
│   ├── operations/      # MCP 工具
│   │   └── security.ts
│   └── index.ts         # 服务器入口点
├── package.json
└── tsconfig.json

添加组件

该项目带有 src/operations/security.ts 中的 GHAS 工具。

构建

更改您的工具
运行 npm run build 进行编译
服务器将在启动时自动加载您的工具

测试本地构建

您可以通过使用以下 MCP 配置配置本地构建版本来测试本地构建：

"servers": {
    "ghas-mcp-server": {
        "command": "node",
        "args": [
            "C:/Users/RobBos/Code/Repos/rajbos/ghas-mpc-server/dist/index.js"
        ],
        "env": {
            "GITHUB_PERSONAL_ACCESS_TOKEN_USE_GHCLI": "true"
        }
    }
}