Intruder MCP

1# Intruder MCP
2 
3Let MCP clients like Claude and Cursor control [Intruder](https://www.intruder.io/). For more information and sample use cases, please see [our blog post](https://www.intruder.io/blog/claude-intruder-mcp#intruder-mcp-use-cases).
4 
5## Installation
6There are two ways to use the MCP server:
7- Locally on your machine with Python
8- In a Docker container
9 
10All of these methods require you to provide an Intruder API key. To generate a key, see [the documentation](https://developers.intruder.io/docs/creating-an-access-token).
11 
12### Running Locally
13Install [uv](https://github.com/astral-sh/uv) if it isn't already present, and then clone this repository and run the following from the root directory:
14 
15```bash
16uv venv
17uv pip install -e .
18```
19 
20Then, add the following to your MCP client configuration, making sure to fill in your API key, and update the path to where you have cloned this repository:
21 
22```json
23{
24  "mcpServers": {
25    "intruder": {
26      "command": "uv",
27      "args": [
28        "--directory",
29        "path/to/intruder-mcp/intruder_mcp",
30        "run",
31        "server.py"
32      ],
33      "env": {
34        "INTRUDER_API_KEY": "your-api-key"
35      }
36    }
37  }
38}
39```
40 
41### Running in a Container
42 
43Add the following to your MCP client configuration, making sure to fill in your API key:
44 
45```json
46{
47  "mcpServers": {
48    "intruder": {
49      "command": "docker",
50      "args": [
51        "container",
52        "run",
53        "--interactive",
54        "--rm",
55        "--init",
56        "--env",
57        "INTRUDER_API_KEY=<your-api-key>",
58        "ghcr.io/intruder-io/intruder-mcp"
59      ]
60    }
61  }
62}
63```
64