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.

• 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.

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

$ git clone [email protected]:girorme/binoculo.git
$ ./binoculo --server
Starting API server on port 4000

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

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

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

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

• Binoculo for providing the core functionality for banner grabbing.