English Français العربية

io.github.mdfifty50-boop/mcp-registry

Official registry Other

MCP server discovery, indexing, and registration

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package mcp-registry-mcp
Claude Code 
claude mcp add mcp-registry -- npx -y mcp-registry-mcp@0.1.1
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "mcp-registry": {
            "command": "npx",
            "args": [
                "-y",
                "mcp-registry-mcp@0.1.1"
            ]
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. mcp-registry-mcp
  2. Install
  3. Tools
  4. Resources
  5. Usage Pattern
  6. Tests
  7. License

mcp-registry-mcp

MCP server for managing MCP server registries — health checks, duplicate detection, and configuration portability.

52% of remote MCP servers are dead. Only 9% are fully healthy. This server gives you a central registry to track what you have, what works, and what overlaps — before MCP sprawl becomes the microservices sprawl of 2018.

Install

npx mcp-registry-mcp
Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "mcp-registry": {
      "command": "npx",
      "args": ["mcp-registry-mcp"]
    }
  }
}
From source
git clone https://github.com/mdfifty50-boop/mcp-registry-mcp.git
cd mcp-registry-mcp
npm install
node src/index.js

Tools

register_server

Register an MCP server with metadata.

ParamTypeDefaultDescription
namestringrequiredServer name (e.g. "filesystem-mcp")
urlstringrequiredServer URL or package name
transportstring"stdio""stdio", "sse", or "streamable-http"
descriptionstring""What this server does
org_idstring"default"Organization for multi-tenant grouping
toolsstring[][]Tool names this server provides
health_check

Check server health. Probes HTTP endpoints, measures latency, tracks uptime over time.

ParamTypeDescription
server_idstringServer ID from register_server

Returns: health status, latency, uptime percentage, last 5 check results.

find_duplicates

Find servers with overlapping tool definitions using Jaccard similarity on tool name sets.

ParamTypeDefaultDescription
org_idstring"default"Organization to scan

Returns pairs of overlapping servers with similarity scores and verdicts: likely_duplicate (>80%), significant_overlap (>50%), or minor_overlap (>30%).

export_config

Export portable MCP configuration for different clients.

ParamTypeDefaultDescription
server_idsstring[]requiredServer IDs to include
target_clientstring"claude_desktop""claude_desktop", "cursor", "vscode", or "generic"

Returns a ready-to-paste JSON config block with client-specific instructions.

get_inventory

List all registered servers with health and usage stats.

ParamTypeDefaultDescription
org_idstring"default"Organization to list ("all" for everything)

Returns: server list with health status, uptime percentage, tool count, and summary stats.

recommend_consolidation

Suggest merging duplicate or overlapping servers to reduce sprawl.

ParamTypeDefaultDescription
org_idstring"default"Organization to analyze

Returns: recommendations to keep/retire specific servers with similarity scores and reasoning.

check_before_install

Pre-install health, security, and duplicate check for a server you are considering adding.

ParamTypeDefaultDescription
server_urlstringrequiredURL or package name to check
transportstring"streamable-http"Transport to probe with
org_idstring"default"Check duplicates against this org

Returns: reachability, latency, TLS status, CORS headers, duplicate risk, and install recommendation (OK / CAUTION / DO NOT INSTALL).

Resources

URIDescription
mcp-registry://serversAll registered servers with current health status

Usage Pattern

1. register_server — add each MCP server you use
2. health_check — verify each server is alive
3. find_duplicates — spot overlapping tools
4. recommend_consolidation — get merge suggestions
5. export_config — generate config for your client
6. check_before_install — vet new servers before adding

Tests

npm test

License

MIT

Frequently asked questions

What is io.github.mdfifty50-boop/mcp-registry?

MCP server discovery, indexing, and registration

How do I install io.github.mdfifty50-boop/mcp-registry?

It runs on your machine. In Claude Code: claude mcp add mcp-registry -- npx -y mcp-registry-mcp@0.1.1. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.mdfifty50-boop/mcp-registry need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is io.github.mdfifty50-boop/mcp-registry open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains io.github.mdfifty50-boop/mcp-registry?

It is published by mdfifty50-boop. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.