mcp.downloader.legacy_core

General MCP Server Downloader - A flexible, configuration-driven approach.

This script provides a general, extensible system for downloading and configuring MCP servers from various sources using configurable installation strategies.

Key features: - Plugin architecture for different installation methods - Configuration-driven patterns and templates - Support for multiple server registries and sources - Flexible metadata handling - Batch processing with retry logic - Progress tracking and logging

Attributes

aiohttp
logger
yaml

Classes

DockerInstaller	Installer for Docker-based MCP servers.
GeneralMCPDownloader	General MCP Server Downloader with configurable patterns and.
GitInstaller	Installer for Git-based MCP servers.
InstallationMethod	Supported installation methods.
MCPInstaller	Abstract base class for MCP installers.
NPMInstaller	Installer for NPM-based MCP servers.
PipInstaller	Installer for Python/pip-based MCP servers.
ServerConfig	Configuration for a specific MCP server.
ServerTemplate	Template for MCP server configuration.

Functions

main()

Main function for CLI usage.

Module Contents

class mcp.downloader.legacy_core.DockerInstaller

Bases: MCPInstaller

Installer for Docker-based MCP servers.

async can_handle(server_config: ServerConfig, template: ServerTemplate) → bool

Can Handle.

Parameters:

• server_config – [TODO: Add description]

• template – [TODO: Add description]

Returns:

Add return description]

Return type:

[TODO

async install(server_config: ServerConfig, template: ServerTemplate, install_dir: pathlib.Path) → dict[str, Any]

Install.

Parameters:

• server_config – [TODO: Add description]

• template – [TODO: Add description]

• install_dir – [TODO: Add description]

Returns:

Add return description]

Return type:

[TODO

async verify(server_config: ServerConfig, template: ServerTemplate, install_dir: pathlib.Path) → bool

Verify.

Parameters:

• server_config – [TODO: Add description]

• template – [TODO: Add description]

• install_dir – [TODO: Add description]

Returns:

Add return description]

Return type:

[TODO

class mcp.downloader.legacy_core.GeneralMCPDownloader(config_file: str | None = None, install_dir: str | None = None)

General MCP Server Downloader with configurable patterns and. installers.

async auto_discover_and_download(limit: int | None = None) → dict[str, Any]

Auto-discover servers from registries and download them.

create_default_config()

Create a default configuration file.

async discover_servers_from_registry(registry_url: str) → list[dict[str, Any]]

Discover MCP servers from a registry or documentation source.

async download_servers(server_names: list[str] | None = None, categories: list[str] | None = None, max_concurrent: int = 5) → dict[str, Any]

Download and install MCP servers.

load_config()

Load configuration from file.

config_file = 'mcp_downloader_config.yaml'

install_dir

installers: list[MCPInstaller]

patterns: dict[str, Any]

servers: list[ServerConfig] = []

templates: dict[str, ServerTemplate]

class mcp.downloader.legacy_core.GitInstaller

Bases: MCPInstaller

Installer for Git-based MCP servers.

async can_handle(server_config: ServerConfig, template: ServerTemplate) → bool

Can Handle.

Parameters:

• server_config – [TODO: Add description]

• template – [TODO: Add description]

Returns:

Add return description]

Return type:

[TODO

async install(server_config: ServerConfig, template: ServerTemplate, install_dir: pathlib.Path) → dict[str, Any]

Install.

Parameters:

• server_config – [TODO: Add description]

• template – [TODO: Add description]

• install_dir – [TODO: Add description]

Returns:

Add return description]

Return type:

[TODO

async verify(server_config: ServerConfig, template: ServerTemplate, install_dir: pathlib.Path) → bool

Verify.

Parameters:

• server_config – [TODO: Add description]

• template – [TODO: Add description]

• install_dir – [TODO: Add description]

Returns:

Add return description]

Return type:

[TODO

class mcp.downloader.legacy_core.InstallationMethod(*args, **kwds)

Bases: enum.Enum

Supported installation methods.

BINARY = 'binary'

CURL = 'curl'

DOCKER = 'docker'

GIT = 'git'

MANUAL = 'manual'

NPM = 'npm'

PIP = 'pip'

SCRIPT = 'script'

class mcp.downloader.legacy_core.MCPInstaller

Bases: abc.ABC

Abstract base class for MCP installers.

abstractmethod can_handle(server_config: ServerConfig, template: ServerTemplate) → bool

Async:

Check if this installer can handle the given configuration.

abstractmethod install(server_config: ServerConfig, template: ServerTemplate, install_dir: pathlib.Path) → dict[str, Any]

Async:

Install the MCP server.

abstractmethod verify(server_config: ServerConfig, template: ServerTemplate, install_dir: pathlib.Path) → bool

Async:

Verify the installation was successful.

class mcp.downloader.legacy_core.NPMInstaller

Bases: MCPInstaller

Installer for NPM-based MCP servers.

async can_handle(server_config: ServerConfig, template: ServerTemplate) → bool

Can Handle.

Parameters:

• server_config – [TODO: Add description]

• template – [TODO: Add description]

Returns:

Add return description]

Return type:

[TODO

async install(server_config: ServerConfig, template: ServerTemplate, install_dir: pathlib.Path) → dict[str, Any]

Install.

Parameters:

• server_config – [TODO: Add description]

• template – [TODO: Add description]

• install_dir – [TODO: Add description]

Returns:

Add return description]

Return type:

[TODO

async verify(server_config: ServerConfig, template: ServerTemplate, install_dir: pathlib.Path) → bool

Verify.

Parameters:

• server_config – [TODO: Add description]

• template – [TODO: Add description]

• install_dir – [TODO: Add description]

Returns:

Add return description]

Return type:

[TODO

class mcp.downloader.legacy_core.PipInstaller

Bases: MCPInstaller

Installer for Python/pip-based MCP servers.

async can_handle(server_config: ServerConfig, template: ServerTemplate) → bool

Can Handle.

Parameters:

• server_config – [TODO: Add description]

• template – [TODO: Add description]

Returns:

Add return description]

Return type:

[TODO

async install(server_config: ServerConfig, template: ServerTemplate, install_dir: pathlib.Path) → dict[str, Any]

Install.

Parameters:

• server_config – [TODO: Add description]

• template – [TODO: Add description]

• install_dir – [TODO: Add description]

Returns:

Add return description]

Return type:

[TODO

async verify(server_config: ServerConfig, template: ServerTemplate, install_dir: pathlib.Path) → bool

Verify.

Parameters:

• server_config – [TODO: Add description]

• template – [TODO: Add description]

• install_dir – [TODO: Add description]

Returns:

Add return description]

Return type:

[TODO

class mcp.downloader.legacy_core.ServerConfig

Configuration for a specific MCP server.

enabled: bool = True

name: str

priority: int = 0

source: str

tags: set[str]

template: str

variables: dict[str, Any]

class mcp.downloader.legacy_core.ServerTemplate

Template for MCP server configuration.

args_pattern: list[str] = []

capabilities: list[str] = []

category: str = 'general'

command_pattern: str

env_vars: dict[str, str]

health_check: str | None = None

installation_method: InstallationMethod

name: str

post_install: list[str] = []

prerequisites: list[str] = []

async mcp.downloader.legacy_core.main()

Main function for CLI usage.

mcp.downloader.legacy_core.aiohttp = None

mcp.downloader.legacy_core.logger

mcp.downloader.legacy_core.yaml = None