# mcp-registry

> MCP server for interacting with the MCP Registry API

[![PyPI](https://img.shields.io/pypi/v/mcp-registry.svg)](https://pypi.org/project/mcp-registry/)
[![Python](https://img.shields.io/pypi/pyversions/mcp-registry.svg)](https://pypi.org/project/mcp-registry/)
[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)

## Install

```bash
pip install mcp-registry
```

## Usage

### As an MCP Server

Configure in your MCP client:

```json
{
  "mcpServers": {
    "mcp-registry": {
      "command": "mcp-registry"
    }
  }
}
```

### Using npx

```json
{
  "mcpServers": {
    "mcp-registry": {
      "command": "npx",
      "args": ["-y", "mcp-registry"]
    }
  }
}
```

## Available Tools

### `list_mcp_servers`

Lists MCP servers from the MCP Registry with pagination.

```python
list_mcp_servers(limit=50, cursor=None, registry_url="https://registry.modelcontextprotocol.io")
```

### `search_mcp_servers`

Searches for MCP servers by name or keywords.

```python
search_mcp_servers(query="search term", limit=50, registry_url="https://registry.modelcontextprotocol.io")
```

### `get_mcp_server`

Gets detailed information about a specific MCP server.

```python
get_mcp_server(name="server-name", registry_url="https://registry.modelcontextprotocol.io")
```

### `get_server_versions`

Gets available versions for a specific MCP server.

```python
get_server_versions(name="server-name", registry_url="https://registry.modelcontextprotocol.io")
```

## Development

```bash
git clone https://github.com/daedalus/mcp-registry.git
cd mcp-registry
pip install -e ".[test]"

# run tests
pytest

# format
ruff format src/ tests/

# lint
ruff check src/ tests/

# type check
mypy src/
```

---

mcp-name: io.github.daedalus/mcp-registry