MCP Registry Navigator

用于从官方 Model Context Protocol Registry 中发现、比较和审计公共服务器的只读 MCP 服务器。

用于从官方 Model Context Protocol Registry 中发现、比较和审查公共服务器的只读 MCP 服务器。

概述

MCP Registry Navigator 帮助代理和开发者在安装或发布 MCP 服务器之前回答实际问题：

• 哪个 MCP 服务器最适合某项任务？

• 它使用什么包注册表、传输方式和安装命令？

• 是否有 server.json 文件已准备好用于注册表发布？

• 在通过 PyPI、npm 或 OCI 发布 MCP 服务器之前，应遵循哪些检查清单？

该服务器不修改任何用户文件。它返回结构化报告、生成的配置片段和审查清单，供调用者检查后手动应用。

Related MCP server: MCP Registry Server

概述

MCP Registry Navigator 帮助代理和开发者在安装或发布 MCP 服务器之前做出正确的决定：

• 哪个 MCP 服务器最适合某项任务？

• 它使用哪个包注册表、传输方式和安装命令？

• server.json 文件是否已准备好用于注册表发布？

• 在通过 PyPI、npm 或 OCI 发布 MCP 服务器之前，应遵循什么检查清单？

该服务器不修改任何用户文件。它返回结构化报告、生成的配置片段和审查清单，调用者可以自行检查并手动应用。

功能 / 功能特性

• 从 https://registry.modelcontextprotocol.io 搜索最新服务器。

• 按注册表名称和版本获取特定服务器。

• 比较服务器的包类型、传输方式和描述。

• 在发布前验证 server.json 元数据。

• 为 PyPI、npm 和 OCI 包生成 MCP 客户端配置片段。

• 为 PyPI、npm 和 OCI 注册表流程准备发布检查清单。

• 通过官方 Python SDK v2 提供 MCP 工具、资源和提示词。

• 使用本地 TTL JSON 缓存和确定性的测试固定数据。

MCP 原语

工具

• search_servers

• get_server

• compare_servers

• validate_server_json

• generate_install_config

• prepare_publish_checklist

资源

• registry://servers/{name}

• registry://latest

• registry://cache/status

提示词

• audit_mcp_metadata

• prepare_mcp_release

Requirements / PreC requirements

• Python 3.12 或更高版本。

• 使用 uv 管理本地 Python 依赖。

• 仅在使用 MCP Inspector 时，需要 Node.js 22.19.0 或更高版本。

安装

在本地检出中：

uv sync
uv run mcp-registry-navigator --version

在本地检出目录中：

uv sync
uv run mcp-registry-navigator --version

使用

通过 standard I/O 运行，这是本地 MCP 客户端的默认传输方式：

uv run mcp-registry-navigator

以 standard I/O 方式运行，这是本地 MCP 客户端的默认传输方式：

uv run mcp-registry-navigator

以 Streamable HTTP 方式运行以进行本地测试：

uv run mcp-registry-navigator --transport streamable-http --host 127.0.0.1 --port 8000

以 Streamable HTTP 方式运行以进行本地测试：

uv run mcp-registry-navigator --transport streamable-http --host 127.0.0.1 --port 8000

运行 MCP Inspector：

npm install
npm run inspect

运行 MCP Inspector：

npm install
npm run inspect

本仓库包含 .node-version 和 package.json，因此本地检查使用 @modelcontextprotocol/inspector v2，而不是某些 mcp dev 环境使用的已弃用 v1 启动器。

本仓库包含 .node-version 和 package.json，以便本地检查使用 @modelcontextprotocol/inspector v2，而不是某些 mCP dev 环境使用的旧版 v1 启动器。

客户端配置示例

在本地检出中：

{
  "mcpServers": {
    "mcp-registry-navigator": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/mcp-registry-navigator",
        "run",
        "mcp-registry-navigator"
      ]
    }
  }
}

发布到 PyPI 后，命令可以简化为：

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

开发 / 开发

uv run python -m pytest -q
uv run ruff check .
uv run mypy
uv build
npm run inspect

测试套件使用伪造的注册表响应，以获得确定性的离线测试覆盖。MCP 集成测试使用 SDK 内存客户端，不开放端口。

测试套件使用模拟的注册表响式，以便保持确定性并在离线环境中运行。MCP 集成测试使用 SDK 内存客户端，不开放任何网络端口。

缓存

默认缓存文件是：

~/.cache/mcp-registry-navigator/registry-cache.json

设置 XDG_CACHE_HOME 可更改缓存根目录。如果不想进行任何磁盘写入，请在测试或嵌入代码中使用 NullCache。

默认缓存文件是：

~/.cache/mcp-registry-navigator/registry-cache.json

设置 XDG_CACHE_HOME 可更改缓存根目录。在测试或嵌入代码中，如果不需要任何磁盘写入，请使用 NullCache。

仓库状态 / 仓库状态

本项目目前是 alpha 软件。随着 MCP Registry 和 Python SDK 的进一步演进，API 和生成的推荐内容可能发生变化。

该项目当前处于 alpha 阶段。由于 MCP Registry 和 Python SDK 仍在演进，API 和生成的建议可能会改变。

发版说明 / 发布说明

在发布到 PyPI 之前，在 pyproject.toml 中添加 [project.urls]，并填入真实 GitHub 仓库 URL 和 issue 跟踪器地址。

在将项目发布到 PyPI 之前，请在 pyproject.toml 的 [project.urls] 中添加真实 GitHub 仓库地址和 issue 跟踪地址。

如果以后要将该服务器作为 PyPI 包发布到 MCP Registry 的官方注册表，请将注册表验证标记添加到本 README 中：

<!-- mcp-name: io.github.YOUR_GITHUB_USERNAME/mcp-registry-navigator -->

如果将来把该服务器作为 PyPI 包发布到 MCP official Registry，请将注册表验证标记添加到本 README 中。

许可证 / License

MIT。参见 LICENSE。