返回 MCP 目录
public公开dns本地运行

binoculo-mcp

BinoculoMCP是一个与Binoculo工具交互的MCP服务器项目,旨在通过发送请求和处理响应来简化横幅抓取操作。

article

README

🚀 BinoculoMCP 项目

BinoculoMCP 是一个消息控制协议(MCP)服务器项目,主要用于与 Binoculo 工具 进行交互。通过向 Binoculo 发送请求并处理其响应,该项目极大地简化了 banner 抓取操作,提升了工作效率。

✨ 主要特性

  • Banner 抓取:能够指示 Binoculo 执行特定任务,例如“抓取 192.168.0.1/24 范围内的所有 Apache 服务器”。
  • 自定义查询:支持用户定义具体的目标和过滤器,以更好地满足不同场景下的 banner 抓取任务需求。

📦 安装指南

先决条件

  • Python3
  • uv
  • Docker(用于运行 binoculo 服务)
  • MCP(sdk)

💻 使用示例

运行 binoculo 服务器

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

在 Claude 桌面运行

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

⚠️ 重要提示

安装完 mcp 服务器后,Copilot 也可以检测到它。

MCP 配置

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

🤝 贡献

欢迎各位开发者为项目贡献力量!您可以随意提交问题或拉取请求,共同改进该项目。

📄 许可证

本项目采用 MIT 许可证。有关详细信息,请参阅 LICENSE 文件。

🙏 致谢

  • Binoculo 为 banner 抓取功能提供了核心功能。
help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端