BinoculoMCP

Name: BinoculoMCP
Author: girorme

@girorme

Repository

About BinoculoMCP

Banner grabbing with LLM (MCP Server)

#python #security #bugbounty #redteam-tools #llm #claude-ai #mcp-server

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

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

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is BinoculoMCP?

BinoculoMCP is a Message Control Protocol (MCP) Server that interacts with the Binoculo tool to perform banner-grabbing operations. It sends requests to Binoculo and processes its responses, intended for users needing to grab banners from network services.

How to use BinoculoMCP?

Install Binoculo server via git clone and run it in server mode. Then use uv run mcp install bridge_mcp_binoculo.py to install the MCP server (e.g., in Claude desktop). Configure the MCP client with the provided JSON entry, specifying the path to the Python bridge script.

Key features of BinoculoMCP

Banner grabbing: request Binoculo to grab banners from a target range.
Customizable queries: define specific targets and filters for banner-grabbing tasks.

Use cases of BinoculoMCP

Grab all Apache servers in a given subnet range.
Automate banner collection from network services for security assessments.

FAQ from BinoculoMCP

What do I need to run BinoculoMCP?

Python3, uv, Docker (to run the Binoculo server), and the MCP SDK.

How do I install the Binoculo server?

Clone the repository from github.com/girorme/binoculo and run ./binoculo --server, which starts an API server on port 4000.

How do I configure my MCP client?

Add the provided JSON block to your MCP client configuration, specifying the command uv with the required arguments pointing to the bridge_mcp_binoculo.py script.