mcp-registry

mcp-registry-mcp

用于管理 MCP 服务注册表的 MCP 服务——健康检查、重复项检测和配置可移植性。

52% 的远程 MCP 服务已失效。只有 9% 完全健康。此服务为你提供一个集中式注册表，用于跟踪你拥有的服务、哪些服务可用以及哪些服务存在重叠——避免 MCP 泛滥演变成 2018 年的微服务泛滥。

安装

npx mcp-registry-mcp

Claude Desktop

添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "mcp-registry": {
      "command": "npx",
      "args": ["mcp-registry-mcp"]
    }
  }
}

从源代码安装

git clone https://github.com/mdfifty50-boop/mcp-registry-mcp.git
cd mcp-registry-mcp
npm install
node src/index.js

工具

register_server

注册带有元数据的 MCP 服务。

参数	类型	默认值	描述
name	string	必填	服务名称（例如 "filesystem-mcp"）
url	string	必填	服务 URL 或包名称
transport	string	"stdio"	"stdio"、"sse" 或 "streamable-http"
description	string	""	此服务的功能
org_id	string	"default"	用于多租户分组的组织
tools	string[]	[]	此服务提供的工具名称

health_check

检查服务健康状况。探测 HTTP 端点、测量延迟并跟踪一段时间内的运行时间。

参数	类型	描述
server_id	string	通过 register_server 获取的服务 ID

返回：健康状态、延迟、运行时间百分比以及最近 5 次检查结果。

find_duplicates

使用工具名称集合的 Jaccard 相似度，查找工具定义重叠的服务。

参数	类型	默认值	描述
org_id	string	"default"	要扫描的组织

返回：重叠服务对及其相似度分数和判定结果：likely_duplicate（>80%）、significant_overlap（>50%）或 minor_overlap（>30%）。

export_config

为不同客户端导出可移植的 MCP 配置。

参数	类型	默认值	描述
server_ids	string[]	必填	要包含的服务 ID
target_client	string	"claude_desktop"	"claude_desktop"、"cursor"、"vscode" 或 "generic"

返回可直接粘贴的 JSON 配置块，以及针对客户端的说明。

get_inventory

列出所有已注册服务及其健康状况和使用统计信息。

参数	类型	默认值	描述
org_id	string	"default"	要列出的组织（"all" 表示全部）

返回：服务列表及其健康状态、运行时间百分比、工具数量和汇总统计信息。

recommend_consolidation

建议合并重复或重叠的服务，以减少泛滥。

参数	类型	默认值	描述
org_id	string	"default"	要分析的组织

返回：关于保留或退役特定服务的建议，并附上相似度分数和理由。

check_before_install

在安装前检查你考虑添加的服务的健康状况、安全性和重复情况。

参数	类型	默认值	描述
server_url	string	必填	要检查的 URL 或包名称
transport	string	"streamable-http"	用于探测的传输方式
org_id	string	"default"	与此组织中的服务检查重复情况

返回：可访问性、延迟、TLS 状态、CORS 标头、重复风险以及安装建议（OK / CAUTION / DO NOT INSTALL）。

资源

URI	描述
mcp-registry://servers	所有已注册服务及其当前健康状态

使用模式

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

测试

npm test

许可证

MIT