MCP Registry

A tool that solves key challenges when working with multiple Model Context Protocol (MCP) servers:

Key Problems Solved

1. Simplified MCP Server Configuration Management

Problem: Managing MCP server configurations typically requires manual JSON editing, which is error-prone and tedious.
Solution: MCP Registry provides an intuitive CLI interface to add, remove, and edit server configurations without directly editing JSON files.

2. Selective Server and Tool Exposure

Problem: When you have a large configuration with many MCP servers and tools, there’s no easy way to expose only a subset without creating and maintaining multiple configuration files.
Solution: MCP Registry lets you run a compound server that includes only specific servers and tools from your main configuration, without creating separate config files.

3. Synchronized Settings Across Tools

Problem: Different MCP clients (Claude Desktop, Cursor, Claude Code) each maintain their own configurations, requiring duplicate setup.
Solution: Configure servers once using MCP Registry and reference them from any client, ensuring consistent settings everywhere.

MCP Registry serves as both a command-line tool for configuration management and a Python library for programmatic access to your MCP servers.

Table of Contents

• Installation
• Usage
  • CLI Tool
    • Basic Commands
    • Advanced Server Configuration
    • Integration with MCP Clients
  • Configuration
    • Config File Location
    • Connection Management
  • Library
• Testing
  • Quick Server Test
  • Testing Tools
• Development
• Documentation
• License

Installation

From PyPI:

pip install mcp-registry

From source:

git clone https://github.com/your-username/mcp-registry.git
cd mcp-registry
git submodule update --init --recursive  # Required for testing
pip install -e .

Usage

1. As a CLI Tool

The command-line interface provides an intuitive way to manage your MCP server configurations:

Basic Commands

# Initialize config
mcp-registry init

# Add servers to your configuration
mcp-registry add everything npx -y @modelcontextprotocol/server-everything
mcp-registry add filesystem npx -y @modelcontextprotocol/server-filesystem

# List all configured servers
mcp-registry list

# Edit configuration directly with your preferred editor
# (validates JSON when saving and keeps a backup)
mcp-registry edit

# List tools provided by configured servers
mcp-registry list-tools                # List all tools from all servers