@mcpfinder/server

@mcpfinder/server

The MCP server that finds MCP servers. Your AI's app store for tools.

MCPfinder is a local MCP server that exposes a searchable index of 25,000+ MCP servers across the Official MCP Registry, Glama, and Smithery. Install it once as a capability on your AI client and from then on your assistant can discover, inspect, and install any MCP server on demand — no manual browsing required.

Quick install

Add the snippet below to your client's MCP config file. First run downloads a pre-built snapshot (~13 MB gzipped) from https://mcpfinder.dev/api/v1/snapshot, so bootstrap takes under a second instead of doing a 10-minute live sync.

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "mcpfinder": {
      "command": "npx",
      "args": ["-y", "@mcpfinder/server"]
    }
  }
}

Restart Claude Desktop.

Cursor

.cursor/mcp.json (project) or ~/.cursor/mcp.json (global):

{
  "mcpServers": {
    "mcpfinder": {
      "command": "npx",
      "args": ["-y", "@mcpfinder/server"]
    }
  }
}

Claude Code

.mcp.json (project) or ~/.claude.json (global) — same snippet as above.

Cline / Roo Code (VS Code)

.vscode/mcp.json:

{
  "servers": {
    "mcpfinder": {
      "command": "npx",
      "args": ["-y", "@mcpfinder/server"]
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json — same snippet as Cursor.

Tools exposed

Four canonical tools, optimized for AI consumption (typed outputSchema + structuredContent for chaining, warning flags, confidence breakdown):

Tool	Purpose
search_mcp_servers	Ranked full-text search by keyword, technology, or use case.
get_server_details	Trust signals, env vars, tool manifest, warnings before install.
get_install_config	Ready-to-paste JSON config for Claude Desktop, Cursor, Claude Code, Cline, or Windsurf.
browse_categories	Single-call category browser (omit category to list; pass category for top servers).

What MCPfinder returns to your AI

• Ranked results with confidenceScore plus a transparent confidenceBreakdown (base, official, verified, popularity, multiSource, penalties).
• warningFlags: deprecated-npm, archived-repo, stale-over-18-months, single-source-only, missing-repository-url, install-method-unclear.
• Install metadata: target file path per OS, required env vars (secrets marked), safe_to_autoinstall and requires_user_secrets signals.

Configuration

Env var	Default	Effect
MCPFINDER_DATA_DIR	~/.mcpfinder/	Where the local SQLite DB lives.
MCPFINDER_DISABLE_SNAPSHOT	unset	Set to 1 to skip snapshot bootstrap and do a live sync instead.
MCPFINDER_SNAPSHOT_BASE	https://mcpfinder.dev/api/v1/snapshot	Override the snapshot host for mirrors / testing.

Links

• Source + issues: https://github.com/mcpfinder/mcpfinder
• MCP Registry: dev.mcpfinder/server
• Website: https://mcpfinder.dev
• AI-facing summary: https://mcpfinder.dev/llms.txt

License

AGPL-3.0-or-later — free for personal, internal, and commercial use; modifications exposed as a network service must be published under the same license.