mcp.downloader.discovery

Server discovery module for finding MCP servers from various sources.

This module provides functionality to discover MCP servers from multiple registries and sources including npm, PyPI, GitHub, and custom registries.

Examples

Basic discovery:

discovery = ServerDiscovery(config) servers = await discovery.discover_all(limit_per_source=10)

Discover from specific source:

servers = await discovery.discover_from_npm(query="mcp server", limit=20)

Classes:

ServerDiscovery: Main discovery class DiscoveredServer: Information about a discovered server

Version: 1.0.0 Author: Haive MCP Team

Attributes

logger

Classes

DiscoveredServer	Information about a discovered MCP server.
ServerDiscovery	Discovers MCP servers from various sources.

Module Contents

class mcp.downloader.discovery.DiscoveredServer(/, **data: Any)

Bases: pydantic.BaseModel

Information about a discovered MCP server.

name

Server name

source

Where it was discovered (npm, github, etc.)

source_url

URL where it was found

description

Server description

package_name

Package name (for npm/pypi)

repo_url

Repository URL (for git)

author

Author/owner name

version

Latest version

stars

GitHub stars or similar metric

tags

Extracted tags

metadata

Additional metadata

Examples

Discovered server info:

author: str | None = None

description: str | None = None

metadata: dict[str, Any] = None

name: str = None

package_name: str | None = None

repo_url: str | None = None

source: str = None

source_url: str | None = None

stars: int | None = None

tags: set[str] = None

version: str | None = None

class mcp.downloader.discovery.ServerDiscovery(config: haive.mcp.downloader.config.DiscoveryConfig)

Discovers MCP servers from various sources.

This class provides methods to discover MCP servers from multiple registries and sources, with support for various search patterns and filtering options.

config

Discovery configuration

discovered_cache

Cache of discovered servers

session

Aiohttp session for HTTP requests

Examples

Using discovery:

async __aenter__()

Async context manager entry.

async __aexit__(exc_type, exc_val, exc_tb)

Async context manager exit.

determine_template(server_data: dict[str, Any]) → str

Determine the appropriate template for a discovered server.

Parameters:

server_data – Discovered server information

Returns:

Template name to use

Examples

Determining template:

async discover_all(limit_per_source: int | None = None) → list[dict[str, Any]]

Discover servers from all configured sources.

Parameters:

limit_per_source – Maximum servers to discover per source. Uses config default if not specified.

Returns:

List of discovered server dictionaries

Examples

Discovering from all sources:

async discover_from_github(api_url: str, limit: int = 100) → list[dict[str, Any]]

Discover servers from GitHub.

Parameters:

• api_url – GitHub API search URL

• limit – Maximum results

Returns:

List of discovered servers

Examples

GitHub discovery:

async discover_from_npm_registry(registry_url: str, limit: int = 100) → list[dict[str, Any]]

Discover servers from npm registry.

Parameters:

• registry_url – NPM registry search URL

• limit – Maximum results to return

Returns:

List of discovered servers

Examples

NPM discovery:

async discover_from_pypi(search_url: str, limit: int = 100) → list[dict[str, Any]]

Discover servers from PyPI.

Parameters:

• search_url – PyPI search URL

• limit – Maximum results

Returns:

List of discovered servers

async discover_from_url(url: str, limit: int = 100) → list[dict[str, Any]]

Discover servers from a generic URL (e.g., README).

Parameters:

• url – URL to parse for server information

• limit – Maximum results

Returns:

List of discovered servers

async search_servers(query: str, sources: list[str] | None = None, limit: int = 50) → list[dict[str, Any]]

Search for servers across sources with a specific query.

Parameters:

• query – Search query

• sources – Specific sources to search (npm, pypi, github)

• limit – Maximum results

Returns:

List of matching servers

Examples

Searching for servers:

config

discovered_cache: dict[str, DiscoveredServer]

session: aiohttp.ClientSession | None = None

mcp.downloader.discovery.logger