Это хранилище содержит исходный код audithub-mcp, сервер MCP для АудитХаб.

audithub-mcp позволяет агентам на основе LLM получать доступ к таким функциям, как:

• Раскрытие информации об организациях и проектах AuditHub Запуск и мониторинг задач инструмента AuditHub
• Доступ к проблемам и выводам AuditHub

По своей конструкции MCP-сервер ограничивает функциональность только чтением и неразрушающим. Дополнительные функции могут быть включены через файл конфигурации.

Предупреждение: LLM могут совершать ошибки. Проверьте все выходы инструментов вручную, прежде чем действовать на них.

Предпосылки

Python 3.12+

• Ув.

Пакет объединяет PAQL в качестве модуля Emscripten WebAssembly. Кроссплатформенный Node.js Время выполнения устанавливается автоматически как зависимость от Python, поэтому validate_paql не требуется. Система установки PAQL или Node.js.

##Установка

audithub-mcp реализован как пакет Python, но в PyPI он пока недоступен. Вы должны установить его непосредственно из этого хранилища.

###Глобальная инсталляция

Если вы используете менеджер пакетов uv, вы можете установить audithub-mcp, используя uv:

###Локальный клон

Из корня репо:

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"
          ]
        }
      }
    }