Catalog MCP Servers with Live Previews
Open-source codebase for mcp.so, a community directory website listing awesome MCP servers - self-hostable with Next.js and Supabase.
Maintainer of this project? Claim this page to edit the listing.
1.0.0Add to Favorites
Why it matters
Discover and browse a curated catalog of MCP servers. This asset provides a web interface with live preview capabilities, powered by a Supabase database.
Outcomes
What it gets done
Browse and discover MCP servers.
View live previews of server directories.
Manage a community-driven catalog.
Integrate with Supabase for data storage.
Install
Add it to your toolbox
Run in your project directory:
curl -fsSL https://spark.entire.vc/get/vb-open-sourced-mcp-servers-directory | bash Overview
Open-Sourced MCP Servers Directory MCP Server
MCP Directory is the open-source Next.js and Supabase codebase behind mcp.so, a community directory website for browsing MCP servers. It is a self-hostable web application, not an installable MCP server with its own tools. Use it to self-host a directory of MCP servers, such as an internal catalog or a fork of mcp.so. Not applicable for adding as an MCP tool to an AI client - it exposes no MCP tools itself.
What it does
MCP Directory is the open-source Next.js codebase behind mcp.so, a community-run directory website for discovering "Awesome MCP Servers." It is the website's source, not an installable MCP server with callable tools - it's meant to be self-hosted if you want to run your own instance of the directory.
When to use - and when NOT to
Use it if you want to self-host a copy of the MCP directory site - for example, to run an internal listing of approved MCP servers for your organization, or to contribute to/fork the public mcp.so project. Do not use it expecting an MCP server you register in Claude Desktop or another MCP client - there are no MCP tools, prompts, or resources exposed here; it's a standard web application (Next.js frontend backed by Supabase) for browsing a directory of other servers.
Capabilities
- Serves a browsable, searchable directory of community-submitted MCP servers.
- Backed by a Supabase database, initialized from the included
data/install.sqlschema. - Runs as a standard Next.js web application with a local dev server.
How to install
git clone https://github.com/chatmcp/mcp-directory.git
cd mcp-directory
pnpm install
Create a Supabase project and run the SQL in data/install.sql to set up the database schema. Add a .env file with SUPABASE_URL, SUPABASE_ANON_KEY, and NEXT_PUBLIC_WEB_URL (e.g. http://localhost:3000) set to your project's values. Then start the dev server:
pnpm dev
Open http://localhost:3000 in a browser to preview the site. The live, publicly hosted version is available at mcp.so.
Who it's for
Developers who want to self-host their own MCP server directory - for an internal catalog, a themed community list, or to contribute to the open-source mcp.so project - rather than end users looking to add an MCP tool to their AI client.
Source README
MCP Directory
a directory for Awesome MCP Servers.
live preview: https://mcp.so
Quick Start
- clone the repo
git clone https://github.com/chatmcp/mcp-directory.git
cd mcp-directory
- install dependencies
pnpm install
- prepare database
create a database with Supabase
run the sql file in data/install.sql
- set env variables
put a .env file in the root directory
with env variables:
SUPABASE_URL=""
SUPABASE_ANON_KEY=""
NEXT_PUBLIC_WEB_URL="http://localhost:3000"
- run the dev server
pnpm dev
- preview the site
open http://localhost:3000 in your browser
Community
About the author
FAQ
Common questions
Discussion
Questions & comments · 0
Sign In Sign in to leave a comment.