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 서버가 특정 작업에 가잓 맞을가요?

• 수 Element: 등록 어느 패키지 등록, 뭔송 방식, 설치 명령어를 사해하나요?

• server.json 파일이 레지스트리 공개를 준비되었나요?

• PyI, npm, OCI MCP 서버를 공개하기 전에 따라야 할 체크리스트는 무엇인가요?

이 서버는 사용자 파일을 편집하지 않습니다. 호출자가 확인한 후 직접 적용할 수 있는 구조화된 보고서, 생성된 구성 snippet, 검토 체크리스트를 반환합니다.

기능

• https://registry.modelcontextprotocol.io에서 최신 서버를 검색합니다.

• 레지스트리 이름과 버전으로 특정 서버를 가져옵니다.

• 서버의 패키지 유형, 전송 방식, 설명을 비교합니다.

• 공개 전에 server.json 메타데이터를 검증합니다.

• PyPI, npm, OCI 패키지용 MCP 클라이언트 설치 스니펫을 생성합니다.

• PyPI, npm, OCI 레지스트리 절차에 맞는 공개 체크리스트를 준비합니다.

• 공식 Python SDK v2를 통해 MCP 도구, 리소스, 프롬포트를 노출합니다.

• 로컬 TTL JSON 캐시와 결정론적 테스트 픽스처를 사용합니다.

MCP 프리미티브

Tools

• search_servers

• get_server

• compare_servers

• validate_server_json

• generate_install_config

• prepare_publish_checklist

Resources

• registry://servers/{name}

• registry://latest

• registry://cache/status

Prompt

• select_mcp_server처럼

• audit_mcp_metadata

• prepare_mcp_release

요구 사항

• Python 3.12 또는 그 이상.

• 로컬 Python 의존성, 관리를 위한 uv.

• MCP Inspector를 사용할 때만 Node.js 22.19.0 이상이 필요합니다.

설치

로컬 체크아웃에서 직접 설치합니다:

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

로컬 클론에서 설치합니다:

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

사용법

로컬 MCP 클라이언트의 기본 전송 수단인 stdio로 실행합니다:

uv run mcp-registry-navigator

로컬 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-versions와 package.json이 포함되어 있어, 로컬 검사에서 일부 mcp dev 환경이 사용하던 구형 v1 러처 대신 @modelcontextprotocol/inspector v2를 사용합니다.

클라이언트 구성 예시

{
  "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의 인-메모리 클라이언트를 사용하며 포트를 열지 않습니다.

캐시

기본 cache 파일입니다:

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

시 기본 파일 야는 형태:

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

XDG_CACHE_HOME를 설정하면 캐시 트를 변경할 수 있습니다. 포함된 디С크 쓰기를 원하지 않는 테스트 또는 코드에서는 NullCache를 사용하세요.

저장소 상태 / 상태

이 프로젝트는 현재 알파 상태입니다. MCP 레지스트리와 Python SDK의 발전에 따라 MIWA 등록에서 권장 사항이 변경될 수 있습니다.

Release Notes

PyPI에 공개하기 전에 pyproject.toml의 [project.urls]에 실제 GitHub repository 주소와 이슈 트래커를 추가하세요.

나중에 이 서버를 공식 MCP 레지스트리에 PyPI 패키지로 공개할 경우, 이 README에 레지스트리 검증 마귀를 추가하세요:

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

이 후에 서버를 MCP 레지스트리의 소개 패키지 PyPI로 공개하게 되면 README에 레지스트리 검증 마귀를 추가하세요.

License / 라이선스

MIT. LICENSE를 참고하세요.