Metadata-Version: 2.4
Name: mcp-recon-ng
Version: 0.1.0
Summary: MCP server exposing full recon-ng OSINT framework functionality
Project-URL: Homepage, https://github.com/daedalus/mcp-recon-ng
Project-URL: Repository, https://github.com/daedalus/mcp-recon-ng
Project-URL: Issues, https://github.com/daedalus/mcp-recon-ng/issues
Author-email: Darío Clavijo <clavijodario@gmail.com>
License: MIT
License-File: LICENSE
Requires-Python: >=3.11
Provides-Extra: all
Requires-Dist: fastmcp>=2.0; extra == 'all'
Requires-Dist: hatch; extra == 'all'
Requires-Dist: mypy; extra == 'all'
Requires-Dist: pip-api; extra == 'all'
Requires-Dist: pytest; extra == 'all'
Requires-Dist: pytest-asyncio; extra == 'all'
Requires-Dist: pytest-cov; extra == 'all'
Requires-Dist: pytest-mock; extra == 'all'
Requires-Dist: ruff; extra == 'all'
Provides-Extra: dev
Requires-Dist: hatch; extra == 'dev'
Requires-Dist: mypy; extra == 'dev'
Requires-Dist: pip-api; extra == 'dev'
Requires-Dist: ruff; extra == 'dev'
Provides-Extra: lint
Requires-Dist: mypy; extra == 'lint'
Requires-Dist: ruff; extra == 'lint'
Provides-Extra: mcp
Requires-Dist: fastmcp>=2.0; extra == 'mcp'
Provides-Extra: test
Requires-Dist: pytest; extra == 'test'
Requires-Dist: pytest-asyncio; extra == 'test'
Requires-Dist: pytest-cov; extra == 'test'
Requires-Dist: pytest-mock; extra == 'test'
Description-Content-Type: text/markdown

# mcp-recon-ng

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

[![PyPI](https://img.shields.io/pypi/v/mcp-recon-ng.svg)](https://pypi.org/project/mcp-recon-ng/)
[![Python](https://img.shields.io/pypi/pyversions/mcp-recon-ng.svg)](https://pypi.org/project/mcp-recon-ng/)
[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)

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

## Install

```bash
pip install mcp-recon-ng
```

Requires recon-ng to be installed separately:
```bash
pip install recon-ng
```

## Usage

### CLI

```bash
mcp-recon-ng
```

### MCP Client Configuration

Add to your MCP client config:

```json
{
  "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

```python
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

```bash
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/
```
