mcpField
M
mcp-recon-ng

mcp-recon-ng

Local
github.com/daedalusSecurity0Updated 27w ago
Repository

About mcp-recon-ng

mcp-recon-ng exposes recon-ng OSINT framework operations to LLMs through an MCP server. It supports workspace, module, marketplace, and database tasks, and requires recon-ng to be installed separately.

Key features

  1. 01Manage recon-ng workspaces
  2. 02Browse and run modules
  3. 03Search and manage marketplace modules
  4. 04Query and modify the database
  5. 05Run recon-ng commands

Use cases

  1. 01Create and switch OSINT workspaces
  2. 02Run a recon-ng module
  3. 03Find or install marketplace modules
  4. 04Inspect or update database records

MCP support

The MCP server exposes recon-ng workspace, module, marketplace, database, and command operations as tools for MCP clients.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "daedalus-mcp-recon-ng": {
      "command": "uvx",
      "args": [
        "mcp-recon-ng"
      ]
    }
  }
}
Run commanduvx mcp-recon-ng

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
pypimcp-recon-ng0.1.0

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

mcp-recon-ng

MCP server exposing full recon-ng OSINT framework functionality to LLMs.

PyPI Python Ruff

mcp-name: io.github.daedalus/mcp-recon-ng

Install

pip install mcp-recon-ng

Requires recon-ng to be installed separately:

pip install recon-ng

Usage

CLI
mcp-recon-ng
MCP Client Configuration

Add to your MCP client config:

{
  "mcpServers": {
    "recon-ng": {
      "command": "mcp-recon-ng",
      "env": {}
    }
  }
}

Available Tools

Workspace Management
  • workspace_list() - List all workspaces
  • workspace_create(name) - Create a new workspace
  • workspace_switch(name) - Switch to a workspace
  • workspace_delete(name) - Delete a workspace
Module Management
  • module_list(category) - List available modules
  • module_load(module_path) - Load a module
  • module_unload() - Unload current module
  • module_options_list() - List module options
  • module_options_set(key, value) - Set module option
  • module_run() - Run loaded module
Marketplace
  • marketplace_search(query) - Search marketplace
  • marketplace_install(module_path) - Install module
  • marketplace_remove(module_path) - Remove module
Database Operations
  • db_query(table, where) - Query database
  • db_insert(table, data) - Insert record
  • db_delete(table, where) - Delete records
Utilities
  • run_command(command) - Execute recon-ng command
  • get_info() - Get system information

Example

from mcp_recon_ng import workspace_create, module_load, module_run

# Create a new workspace
workspace_create("osint_project")

# Load a module
module_load("recon/domains-whois/whois_miner")

# Set module options
module_options_set("SOURCE", "example.com")

# Run the module
result = module_run()

Development

git clone https://github.com/daedalus/mcp-recon-ng.git
cd mcp-recon-ng
pip install -e ".[test]"

# run tests
pytest

# format
ruff format src/ tests/

# lint
ruff check src/ tests/

# type check
mypy src/

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.