mcp_subfinder_server

mcp_subfinder_server

2
security

MCP Subfinder Server is a wrapper around ProjectDiscovery's subfinder tool that provides subdomain enumeration via a JSON-RPC API. It supports advanced features such as recursive discovery and source filtering and can be deployed using Docker.

MCP Subfinder Server

  • A Model Context Protocol (MCP) server for subdomain enumeration using ProjectDiscovery's subfinder.
  • Features include a JSON-RPC API for subdomain discovery, recursive discovery, source filtering, configurable timeouts, and detailed logging.
  • Supports various Makefile commands for building, running, testing, and more.
  • Docker support is provided for building and running the server in a container.
  • Integration with provider-config.yaml for enhanced subdomain discovery through premium sources.

Installation

  • Clone the repository and use Makefile to build and run the server.

API Usage

  • JSON-RPC API available at http://localhost:8080/mcp with examples given for initialization, listing tools, subdomain enumeration, and health check.

Configuration

  • Customize provider configuration for better subdomain discovery.

Testing

  • Use Makefile for running various tests and check API endpoints using provided Postman collection.