@mcpfinder/server
v1.1.0
Published
MCP server discovery tool for AI agents. Searches MCP servers across Official Registry, Glama, and Smithery so your AI can find, evaluate, and install tools on demand.
Maintainers
Readme
@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
confidenceScoreplus a transparentconfidenceBreakdown(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_autoinstallandrequires_user_secretssignals.
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.
