Binoculo MCP

🚀 BinoculoMCP Project

This project is a Message Control Protocol (MCP) server designed to interact with the Binoculo tool. Its goal is to simplify banner grabbing operations by sending requests to Binoculo and processing its responses.

🚀 Quick Start

Prerequisites

• Python3
• uv
• Docker (for running the binoculo service)
• MCP (sdk)

Usage

Run the binoculo server

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

Run on the Claude desktop

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

After installing the mcp server, Copilot can also detect it.

MCP Configuration

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

✨ Features

• Banner Grabbing: Instruct Binoculo to perform specific tasks, such as "grab all Apache servers in the 192.168.0.1/24 range".
• Custom Queries: Define specific targets and filters for banner grabbing tasks.

🤝 Contribution

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

📄 License

This project is licensed under the MIT License. For more details, please refer to the LICENSE file.

🙏 Acknowledgments

• Binoculo provides the core functionality for banner grabbing.