MCP.so — Open-Source MCP Server Directory
Self-host your own MCP server directory with Next.js and Supabase. Browse, search, and submit community MCP servers. Powers mcp.so. Apache-2.0, 2,000+ stars.
Review-first install path
This asset needs a review step. The copied prompt tells the agent to dry-run, show the writes, then proceed only after confirmation.
npx -y tokrepo@latest install a3e80e57-33ca-11f1-9bc6-00163e2b0d79 --target codexDry-run first, confirm the writes, then run this command.
What it is
MCP.so is an open-source directory for Model Context Protocol servers. Built with Next.js and Supabase, it lets users browse, search, and submit community MCP servers. The project powers the mcp.so website and can be self-hosted for private MCP server directories. It ships under the Apache-2.0 license.
This tool is for developers looking for MCP servers to use with Claude, and for organizations that want to maintain a private catalog of approved MCP integrations.
How it saves time or tokens
Finding MCP servers scattered across GitHub repositories is time-consuming. MCP.so centralizes discovery with search, categorization, and metadata. Each listing includes installation instructions, configuration snippets, and compatibility information. For organizations, a self-hosted instance serves as a vetted catalog of approved MCP servers.
How to use
- Browse mcp.so or self-host your own instance.
- Search for MCP servers by function or keyword.
- Copy the configuration snippet for your MCP client.
- Submit new servers to the directory.
# Self-host MCP.so
git clone https://github.com/chatmcp/mcp.so.git
cd mcp.so
# Set up environment variables
cp .env.example .env.local
# Edit .env.local with your Supabase credentials
# Install and run
npm install
npm run dev
# Access at http://localhost:3000
Example
A typical MCP server listing on the directory:
{
"name": "filesystem",
"description": "Read, write, and manage files on the local filesystem",
"repository": "https://github.com/modelcontextprotocol/servers",
"category": "filesystem",
"config": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/dir"]
},
"compatible_clients": ["Claude Desktop", "Claude Code"]
}
Copy the config object directly into your MCP client settings.
Related on TokRepo
- MCP filesystem — File system MCP server
- AI agent tools — More agent tool integrations
Common pitfalls
- Community-submitted servers are not vetted for security. Review server code before granting access to sensitive resources.
- Self-hosting requires Supabase (or a PostgreSQL database with Supabase client). The setup has a learning curve.
- MCP server compatibility varies across clients. A server that works with Claude Desktop may need adjustments for other clients.
- The directory is a catalog, not a package manager. You still need to install MCP servers separately.
- Listings may become outdated as servers evolve. Check the linked repository for the latest version.
- Review the official documentation before deploying to production to ensure compatibility with your specific environment and requirements.
- Start with default settings and customize incrementally. Changing too many configuration options at once makes debugging harder.
Frequently Asked Questions
MCP.so is a directory for discovering MCP servers. Browse by category, search by keyword, and find configuration snippets for adding MCP servers to your AI client setup.
Yes. The project is open-source under Apache-2.0. Clone the repository, configure Supabase credentials, and deploy. This is useful for organizations maintaining a private catalog of approved MCP servers.
Use the submission form on mcp.so or create a pull request on the GitHub repository. Provide the server name, description, repository URL, installation instructions, and compatible clients.
No. It includes community-submitted servers. New servers may not be listed yet. The official Anthropic MCP servers are typically included, along with popular community servers.
MCP.so is a community project, not an official Anthropic product. It catalogs servers that implement the Model Context Protocol specification published by Anthropic.
Citations (3)
- MCP.so GitHub— MCP.so is an open-source MCP server directory
- MCP Documentation— Model Context Protocol specification
- MCP.so Website— MCP server registry and discovery
Related on TokRepo
Source & Thanks
Created by idoubi. Licensed under Apache-2.0.
chatmcp/mcpso — ⭐ 2,000+
Thanks to idoubi for building the go-to directory for the MCP ecosystem.
Discussion
Related Assets
Headscale — Open Source Self-Hosted Tailscale Control Server
Headscale is an open-source implementation of the Tailscale control server. Run your own private mesh VPN with WireGuard, no Tailscale subscription needed.
Goose — Open-Source AI Dev Agent by Block
Goose is Block's open-source AI agent that automates developer workflows. 33.8K+ stars. Extensible plugins, MCP support, multi-tool orchestration. Apache 2.0.
Void — Open-Source Cursor Alternative
Void is an open-source AI code editor alternative to Cursor. 28.5K+ stars. Checkpoints, custom models, local hosting, built on VS Code. Apache 2.0.
Reactive Resume — AI-Powered Open-Source Resume Builder
Free open-source resume builder with AI integration. Supports Claude, GPT, Gemini for content generation. Drag-and-drop, PDF export, self-hostable, privacy-first. MIT, 36,000+ stars.