Metadata-Version: 2.5
Name: serverdex
Version: 0.1.0
Summary: Tiny Python client for Serverdex — search 60,000+ MCP servers from the official registry.
Project-URL: Homepage, https://serverdex.io
Project-URL: Documentation, https://serverdex.io/developers
Project-URL: Source, https://github.com/hellolistifyai/serverdex-py
Author-email: Serverdex <hello@serverdex.io>
License: MIT
License-File: LICENSE
Keywords: agents,ai,claude,cursor,directory,llm,mcp,model-context-protocol,serverdex
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.8
Description-Content-Type: text/markdown

# serverdex

A tiny Python client for [Serverdex](https://serverdex.io) — the directory of Model Context Protocol (MCP) servers. Serverdex indexes 60,000+ MCP servers from the official registry, with install configs, GitHub signals and category rankings.

No API key, no dependencies (standard library only).

## Install

```bash
pip install serverdex
```

## Use

```python
import serverdex

# Search the directory
for s in serverdex.search("postgres", limit=5):
    print(s["name"], "—", s["url"])

# Filter by category and sort by stars
serverdex.search(category="databases", sort="stars", limit=10)

# Get one server by slug (from a serverdex.io/server/<slug> URL)
server = serverdex.get("io-github-ccxt-ccxt-mcp")
print(server["description"], server["repository_url"])

# List categories with live server counts
for c in serverdex.categories():
    print(c["name"], c["servers"])
```

Or with an explicit client:

```python
from serverdex import Client

client = Client()
results = client.search("calendar", sort="new", limit=20)
```

## API

- `search(query=None, *, category=None, sort=None, limit=10, page=1)` — list of server dicts.
- `get(slug)` — one server's full details.
- `categories()` — categories with live counts.

Backed by the public Serverdex API at `https://serverdex.io/api/v1`. Browse the directory at [serverdex.io](https://serverdex.io).

## License

MIT
