# MCPfinder - MCP Server Discovery

A local MCP server that finds, inspects, and installs other MCP servers from registries. Use it when an agent needs to discover a tool for a task.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 13
- Author: mcpfinder
- License: AGPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/mcpfinder/mcpfinder/tree/HEAD/packages/mcp-server
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/mcp/mcpfinder-mcp-server-discovery

## What it does

MCPfinder gives an AI client a searchable catalog of MCP servers from the Official MCP Registry, Glama, and Smithery. The assistant can inspect entries and install a selected server on demand, so discovery happens from the client rather than through manual catalog browsing.

At startup, the server fetches a compressed catalog snapshot in the background, verifies it with sha256, and switches to the new database without a restart. If snapshot retrieval fails, it falls back to a live registry sync, processing sources in sequence from the Official MCP Registry onward. The catalog is checked once a day.

It runs through `npx -y @mcpfinder/server`. If both snapshot artifacts fail, the server uses live sync instead of stopping.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add server -- npx -y @mcpfinder/server
```

### Codex

**Platform CLI**
```bash
codex mcp add mcp-server -- npx -y @mcpfinder/server
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "@mcpfinder/server"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp-server": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@mcpfinder/server"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add mcp-server npx -y @mcpfinder/server
```

## When to use it
- find an MCP server for an agent task
- inspect an available MCP server entry
- install a selected server from the catalog
- refresh a local MCP server index

## Example prompts
- Find an MCP server for this task, show its details, and install the selected option.
- Check which MCP servers are available in the Official MCP Registry and Glama.
- Show matching entries, then install the MCP server I choose.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 392262
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33989
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81163
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119231
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47577
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43902

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md