이 저장소는 소스 코드를 포함 audithub-mcp, MCP 서버 감사합니다.

audithub-mcp LLM 기반 에이전트는 다음과 같은 기능을 액세스 할 수 있습니다.

• AuditHub 조직 및 프로젝트에 대한 정보를 발견
• 발사 및 모니터링 AuditHub 도구 작업
• Accessing AuditHub 문제 및 발견

디자인에 의하여, MCP 서버는 읽기 전용과 비파괴적인 기능 한계를 제한합니다. 추가 기능은 구성 파일을 통해 활성화 될 수 있습니다.

** 경고:** LLMs 실수를 만들 수 있습니다. 모든 도구 출력을 수동으로 변환하기 전에 그들에 행동합니다.

필수품

• 파이썬 3.12+
• 비

패키지 번들 PAQL은 Emscripten WebAssembly 모듈로 묶습니다. 크로스 플랫폼 Node.js 런타임은 Python 의존성으로 자동으로 설치되므로 validate_paql는 필요하지 않습니다. 시스템 PAQL 또는 Node.js 설치.

설치

audithub-mcp는 Python 패키지로 구현되지만 PyPI에서 사용할 수 없습니다. 이 저장소에서 직접 설치해야합니다.

글로벌 설치

uv 패키지 관리자를 사용하는 경우 audithub-mcp를 사용하여 uv를 설치할 수 있습니다.

# # 지역 복제

repo 루트에서:

AuditHub MCP Server

This repository contains the source code of audithub-mcp, an MCP server for AuditHub.

audithub-mcp allows LLM-based agents to access functionality such as:

• Discovering information about AuditHub organizations and projects
• Launching and monitoring AuditHub tool tasks
• Accessing AuditHub issues and findings

By design, the MCP server limits the functionality to be read-only and non-destructive. Additional features can be enabled through the configuration file.

Warning: LLMs can make mistakes. Verify all tool outputs manually before acting on them.

Prerequisites

• Python 3.12+
• uv

The package bundles PAQL as an Emscripten WebAssembly module. Its cross-platform Node.js runtime is installed automatically as a Python dependency, so validate_paql does not require a system PAQL or Node.js installation.

Installation

audithub-mcp is implemented as a Python package, but it is not yet available in PyPI. You must install it directly from this repository.

Global Installation

If you are using the uv package manager, you can install audithub-mcp using uv:

uv tool install 'git+https://github.com/Veridise/audithub-mcp'
audithub-mcp --help

AuditHub MCP uses the MCP Python SDK v2 API (mcp>=2.3.0,<3). To replace an older installation, including one installed with an explicit mcp<2 constraint, install the updated checkout from its repository root:

uv tool install --force .
audithub-mcp --help

Local Clone

From the repo root:

uv venv
uv sync --active

If your virtual environment is already active and you just want to run the server entrypoint, use:

uv run audithub-mcp --help

Using audithub-mcp

To use audithub-mcp, you need to configure two parts: your agent and the audithub-mcp config file. Once both are configured, the agent should automatically start the MCP server and use its tools.

Agent Configuration

To enable audithub-mcp in your agent, you must add it to the MCP server config for your agent.

The following examples assume that audithub-mcp is available on PATH, and that your config file is located at ~/.config/audithub-mcp/config.yaml.

• Codex CLI
  • For interactive setup, use codex mcp add audithub-mcp
  • If you want to set it up with a config file, add the following to your .codex/config.toml:

    [mcp_servers.audithub-mcp]
    command = "audithub-mcp"
    args = ["--config", "~/.config/audithub-mcp/config.yaml"]
    

• Claude Code
  • For interactive setup, use claude mcp add audithub-mcp audithub-mcp
  • If you want to set it up with a config file, add the following to your .claude/mcp.json:

    {
      "mcpServers": {
        "audithub-mcp": {
          "command": "audithub-mcp",
          "args": [
            "--config",
            "~/.config/audithub-mcp/config.yaml"
          ]
        }
      }
    }