BinoculoMCP

This project is a Message Control Protocol (MCP) Server designed to interact with the Binoculo tool. The goal of this project is to facilitate banner-grabbing operations by sending requests to Binoculo and processing its responses.

Features

• Banner Grabbing: Ask Binoculo to perform operations like "grab all the Apache servers in the 192.168.0.1/24 range."
• Customizable Queries: Define specific targets and filters for your banner-grabbing tasks.

Prerequisites

• Python3
• uv
• Docker (to run binoculo server)
• MCP (sdk)

Usage

https://github.com/user-attachments/assets/88024174-7cac-496b-a667-56e618890d02

Installation

Run binoculo server

$ git clone git@github.com:girorme/binoculo.git
$ ./binoculo --server
Starting API server on port 4000

Claude desktop

R:\repositorios\binoculo-mcp> uv run mcp install bridge_mcp_binoculo.py

Once the mcp server is istalled via claude, copilot can detect it too

Mcp config

{
  "mcpServers": {
    "binoculo-mcp": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "--with",
        "requests",
        "mcp",
        "run",
        "R:\\path-to\\binoculo-mcp\\bridge_mcp_binoculo.py"
      ]
    }
  }
}

Contributing

Contributions are welcome! Feel free to open issues or submit pull requests to improve this project.

License

This project is licensed under the MIT License. See the LICENSE file for details.

Acknowledgments

• Binoculo for providing the core functionality for banner grabbing.