EG

edenyavin/garak-mcp

开发工具

本页由 AI 翻译,技术细节请以原文为准。 查看原文

8 stars 7 forks 质量 74 趋势 16MIT

MCP Server for using Garak LLM vulnerability scanner

概览

A lightweight MCP (Model Context Protocol) server for Garak. https://github.com/user-attachments/assets/f6095d26-2b79-4ef7-a889-fd6be27bbbda - - List all available model types that can be used for attacks - Returns a list of supported model types (ollama, openai, huggingface, ggml) - - List all available models for a given model type - Input parameters: - model_type (string, required): The type of model to list (ollama, openai, huggingface, ggml) - Returns a list of available models for the specified type - - List all available Garak attacks/probes - Returns a list of available probes/attacks that can be run - - Get the report of the last run - Returns the path to the report file - - Run an attack with the given model and probe - Input parameters: - model_type (string, required): The type of model to use - model_name (string, required): The name of the model to use - probe_name (string, required): The name of the attack/probe to use - Returns a list of vulnerabilities found 1.

README

以下为原文 README 节选,完整内容请查看原文。

MCP Server For Garak LLM Vulnerability Scanner

A lightweight MCP (Model Context Protocol) server for Garak.

Example:

https://github.com/user-attachments/assets/f6095d26-2b79-4ef7-a889-fd6be27bbbda


Tools Provided

Overview

Name Description
list_model_types List all available model types (ollama, openai, huggingface, ggml)
list_models List all available models for a given model type
list_garak_probes List all available Garak attacks/probes
get_report Get the report of the last run
run_attack Run an attack with a given model and probe

Detailed Description

  • list_model_types

    • List all available model types that can be used for attacks
    • Returns a list of supported model types (ollama, openai, huggingface, ggml)
  • list_models

    • List all available models for a given model type
    • Input parameters:
      • model_type (string, required): The type of model to list (ollama, openai, huggingface, ggml)
    • Returns a list of available models for the specified type
  • list_garak_probes

    • List all available Garak attacks/probes
    • Returns a list of available probes/attacks that can be run
  • get_report

    • Get the report of the last run
    • Returns the path to the report file
  • run_attack

    • Run an attack with the given model and probe
    • Input parameters:
      • model_type (string, required): The type of model to use
      • model_name (string, required): The name of the model to use
      • probe_name (string, required): The name of the attack/probe to use
    • Returns a list of vulnerabilities found

Prerequisites

  1. Python 3.11 or higher: This project requires Python 3.11 or newer.

    # Check your Python version
    python --version
    
  2. Install uv: A fast Python package installer and resolver.

    pip install uv
    

    Or use Homebrew:

    brew install uv
    
  3. Optional: Ollama: If you want to run attacks on ollama models be sure that the ollama server is running.

ollama serve

Installation

  1. Clone this repository:
git clone https://github.com/BIGdeadLock/Garak-MCP.git
  1. Configure your MCP Host (Claude Desktop ,Cursor, etc):
{
  "mcpServers": {
    "garak-mcp": {
      "command": "uv",
      "args": ["--directory", "path-to/Garak-MCP", "run", "garak-server"],
      "env": {}
    }
  }
}


Tested on:

  • [X] Cursor
  • [X] Claude Desktop

Running Vulnerability Scans

You can run Garak vulnerability scans directly using the included CLI tool.

Prerequisites for Scanning

  1. Ollama must be running:

    ollama serve
    
  2. Pull a model to scan:

    ollama pull llama2
    

Using the CLI Scanner

After installation, you can use the garak-scan command:

# List available Ollama models
uv run garak-scan --list-models

# Scan a specific model with all probes
在 GitHub 查看完整 README

安装

This server does not publish a one-line install command.

Open the repository installation guide 新手?先看 mcpskill.org 教程 →

配置

{ "mcpServers": { "garak-mcp": { "command": "uv", "args": ["--directory", "path-to/Garak-MCP", "run", "garak-server"], "env": {} } } }