mcp.registry

Registry Management for MCP Servers.

This module provides comprehensive tools for managing the MCP server registry, supporting the transition from Git-based to NPM package-based server distribution.

Key Features

Server Registry Management

• Converting GitHub repositories to npm package format

• Validating npm package existence and compatibility

• Organizing servers into logical categories

• Expanding the registry from the 1900+ server database

Phase 3+ Implementation

The registry system supports Phase 3+ of the MCP implementation plan, focusing on package-based installation rather than Git cloning for improved reliability and performance.

Available Classes

Server Management

• ServerConverter - Convert GitHub repos to npm packages

• ServerConverterConfig - Configuration for server conversion

Registry Operations

• Package Validation: Verify npm package existence

• Category Organization: Logical server grouping

• Database Expansion: Scale from existing server collections

Usage Example

from haive.mcp.registry import ServerConverter

# Convert GitHub repo to npm package
converter = ServerConverter()
package_info = converter.convert_repo_to_package(
    "github.com/user/mcp-server",
    category="development"
)

See also

• haive.mcp.downloader for package installation

• haive.mcp.discovery for server discovery

Submodules

• mcp.registry.server_converter

Classes

NPMPackageValidator	Validates whether npm packages exist and are installable.
ServerConversion	Result of converting a GitHub server to npm package format.
ServerConverter	Converts server entries from GitHub format to npm package format.

Package Contents

class mcp.registry.NPMPackageValidator

Validates whether npm packages exist and are installable.

async __aenter__()

async __aexit__(*args)

async package_exists(package_name: str) → bool

Check if an npm package exists.

async validate_batch(package_names: List[str]) → Dict[str, bool]

Validate multiple packages in parallel.

session: aiohttp.ClientSession | None = None

class mcp.registry.ServerConversion

Result of converting a GitHub server to npm package format.

category_guess: str | None = None

confidence: float = 0.0

github_url: str

potential_npm_packages: List[str]

validated_package: str | None = None

class mcp.registry.ServerConverter

Converts server entries from GitHub format to npm package format.

async convert_batch(server_entries: List[Dict]) → List[ServerConversion]

Convert multiple server entries in parallel.

convert_github_to_npm_candidates(github_url: str) → List[str]

Convert a GitHub URL to potential npm package names.

async convert_server_entry(github_url: str, description: str = '') → ServerConversion

Convert a single server entry.

create_registry_categories(conversions: List[ServerConversion]) → Dict[str, List[str]]

Create registry categories from validated conversions.

guess_category(server_name: str, description: str = '') → str | None

Guess the category based on server name and description.

category_mapping

conversion_patterns = [('github\\.com/modelcontextprotocol/server-(\\w+)', '@modelcontextprotocol/server-\\1'),...

validator