Metadata-Version: 2.4
Name: mcp-registry-client
Version: 0.1.0
Summary: A native MCP Server that searches a global registry of MCP tools.
Author-email: MCP Registry <hello@example.com>
Requires-Python: >=3.10
Requires-Dist: httpx
Requires-Dist: mcp
Description-Content-Type: text/markdown

# MCP Registry Client

The MCP Registry Client is a native Model Context Protocol (MCP) server that allows your AI agents (like Claude Desktop) to programmatically search, discover, and install other MCP servers. 

It implements the "Inception Protocol" — using an MCP tool to find MCP tools.

## Installation

You can install and run this server directly via `uvx` (recommended) or `npx`:

### Using Claude Desktop

Add the following to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "search_mcp_registry": {
      "command": "uvx",
      "args": ["mcp-registry-client"]
    }
  }
}
```

## Features

- **Agentic Discovery:** Claude can automatically search the registry when you ask "Do you have a tool to search the web?" or "Connect to my Postgres database."
- **Auto-Installation Commands:** The registry provides the exact `uvx` or `npx` commands required to install the discovered servers.

## Configuration (Optional)

This client connects to the public beta of the MCP Registry backend by default. If you host your own backend or have a premium API key, you can override the defaults using environment variables:

```json
{
  "mcpServers": {
    "search_mcp_registry": {
      "command": "uvx",
      "args": ["mcp-registry-client"],
      "env": {
        "REGISTRY_API_URL": "https://your-custom-api.com/v1/tools",
        "REGISTRY_API_KEY": "your_personal_api_key"
      }
    }
  }
}
```
