このリポジトリには、MCP サーバーの [audithub-mcp] のソースコードが含まれています。 監査ハブ。

[audithub-mcp] では、LM ベースのエージェントが以下のような機能にアクセスできるようにします。

• 監査法人やプロジェクトに関する情報をご覧いただけます。
• 起動と監視の監査ツールタスク
• 監査ハブの問題と発見へのアクセス

設計により、MCP サーバーは読み取り専用および非破壊的である機能を制限します。 設定ファイルで追加機能を有効にできます。

警告: LLMは間違いを犯すことができます。 操作の前に手動ですべてのツール出力を確認します。

前提条件

• Python 3.12 +
• 紫外線

パッケージは、Emscripten WebAssembly モジュールとしてPAQLをバンドルします。 クロスプラットフォームNode.js runtime は Python の依存性として自動的にインストールされますので、[validate_paql] は必須ではありません。 システム PAQL または Node.js のインストール

インストール

[audithub-mcp は Python パッケージとして実装されていますが、PyPI では利用できません。 このリポジトリから直接インストールする必要があります。

###グローバルインストール

[uv]パッケージマネージャを使用している場合は、[audithub-mcp]]を使用してインストールできます。

##ローカルクローン

リポジトリのルートから:

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