This is a Next.js project bootstrapped with create-next-app.
A Model Context Protocol (MCP) server registry that provides both a web interface and an API compatible with the official MCP registry specification.
When registering this MCP registry on GitHub use BASE_URL/api as the registry URL (e.g. https://mcp-registry.example.com/api). If you don't keep the /api suffix, GitHub will not be able to find the registry endpoints.
- 🔍 Web Interface - Browse and search MCP servers through a user-friendly UI
- 🔌 API Endpoints - RESTful API compatible with official MCP registry clients
- 📦 Dual Format Support - Returns data in both MCP format (default) and legacy format
- 🏷️ Filtering & Search - Filter by tags, vendors, search queries, and more
- ⭐ Featured & Verified - Highlight trusted and popular servers
- 🚀 Dynamic Registry Fetching - Automatically fetches latest versions and stats from npm, Docker Hub, and GitHub
- ⚡ Smart Caching - Intelligent caching reduces external API calls while keeping data fresh
- 🤖 IssueOps - Add new servers via GitHub issues with automated PR creation
See API.md for complete API documentation.
# List all servers (MCP format)
curl http://localhost:3000/api/v0/servers
# Search for servers
curl http://localhost:3000/api/v0/servers?q=github
# Get specific server
curl http://localhost:3000/api/v0/servers/github
# Health check
curl http://localhost:3000/api/v0/healthnpm install- Copy the example environment file:
cp .env.example .env.local- (Optional) Add your GitHub token for higher API rate limits:
GITHUB_TOKEN=your_github_token_hereSee Dynamic Registry Fetching for more configuration options.
npm run dev
# or
yarn dev
# or
pnpm dev
# or
bun devOpen http://localhost:3000 with your browser to see the result.
You can start editing the page by modifying app/page.tsx. The page auto-updates as you edit the file.
This project uses next/font to automatically optimize and load Geist, a new font family for Vercel.
- Contributing Guide - Add servers via GitHub issues (IssueOps)
- Minimal Server Configuration - Quick guide to adding servers (minimal JSON)
- API Documentation - Complete API reference
- Dynamic Registry Fetching - Auto-updating from npm, Docker Hub, and GitHub
To learn more about Next.js, take a look at the following resources:
- Next.js Documentation - learn about Next.js features and API.
- Learn Next.js - an interactive Next.js tutorial.
You can check out the Next.js GitHub repository - your feedback and contributions are welcome!
The easiest way to deploy your Next.js app is to use the Vercel Platform from the creators of Next.js.
Check out our Next.js deployment documentation for more details.