mcp-registry

Self-hostable read-only MCP registry server following the official MCP registry specification.

Architecture

• Next.js app with a React Server Component UI and a Hono API mounted at /api
• Registry source is a JSON file (local path or URL) matching the MCP registry schema
• API provides search, cursor pagination, and an OpenAPI spec at /api/openapi.json
• UI uses shadcn/ui with dark mode via next-themes and instant search via nuqs

Development

pnpm install
cp .env.example .env
pnpm run dev

Set MCP_REGISTRY_SOURCE_PATH in .env to a local JSON file or a raw GitHub URL:

MCP_REGISTRY_SOURCE_PATH=./fixtures/registry.json

Other scripts:

pnpm run typecheck    # type check
pnpm run test         # run tests
pnpm run fmt          # format with prettier
pnpm run fmt:check    # check formatting

Deployment

Deploy to Vercel or any platform that supports Next.js:

vercel

Set MCP_REGISTRY_SOURCE_PATH as an environment variable pointing to your registry JSON file.

Example

An example server running mcp-registry is mcp-registry.agent-tooling.dev.