Metadata-Version: 2.4
Name: mcp-advisor
Version: 0.2.3
Summary: MCP server to browse, search, and discover MCP servers from the MCP Advisor registry
Project-URL: Homepage, https://mcpadvisor.stucchi.consulting
Project-URL: Repository, https://github.com/stucchi/mcp-advisor
Project-URL: Issues, https://github.com/stucchi/mcp-advisor/issues
Author-email: Luca Stucchi <luca.stucchi@gmail.com>
License-Expression: MIT
License-File: LICENSE
Keywords: advisor,mcp,model-context-protocol,registry
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.11
Requires-Dist: httpx>=0.27.0
Requires-Dist: mcp>=1.0.0
Description-Content-Type: text/markdown

# MCP Advisor

<!-- mcp-name: io.github.stucchi/mcp-advisor -->

<p align="center">
  <img src="assets/icon.png" alt="MCP Advisor" width="200">
</p>

An MCP server that lets your AI assistant browse, search, and discover MCP servers from the [MCP Advisor](https://mcpadvisor.stucchi.consulting) registry.

## Installation

```bash
pip install mcp-advisor
```

## Usage

### With Claude Desktop

Add to your `claude_desktop_config.json`:

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

### With Cursor

Add to `.cursor/mcp.json`:

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

### Standalone

```bash
mcp-advisor                          # stdio transport (default)
mcp-advisor --transport sse          # SSE transport
mcp-advisor --api-token YOUR_TOKEN   # authenticated (for starring)
```

## Tools

| Tool | Description |
|------|-------------|
| `search_servers` | Search MCP servers with filters (query, transport, registry type, tag, sort) |
| `get_server_details` | Get full details about a specific server |
| `get_install_instructions` | Get install config for Claude Desktop, Cursor, or generic |
| `star_server` | Star a server (requires auth token) |
| `unstar_server` | Remove a star (requires auth token) |
| `list_starred_servers` | List your starred servers (requires auth token) |
| `get_trending_servers` | Get trending servers by star count |
| `get_registry_stats` | Get registry statistics |
| `browse_tags` | List all tags with server counts |

## License

MIT - Luca Stucchi
