# 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.

## Install

Save in your project root:

## Quick Use

1. Clone and install:
```bash
git clone https://github.com/chatmcp/mcp-directory.git
cd mcp-directory
pnpm install
```

2. Set up Supabase database and configure `.env`:
```
SUPABASE_URL=your_supabase_url
SUPABASE_ANON_KEY=your_anon_key
NEXT_PUBLIC_WEB_URL=http://localhost:3000
```

3. Run the dev server:
```bash
pnpm dev
```

---

## Intro

MCP.so is the open-source MCP server directory that powers [mcp.so](https://mcp.so), with 2,000+ GitHub stars. Built with Next.js + Supabase + Tailwind CSS, it lets you browse, search, and submit community MCP servers. Best for developers building their own MCP ecosystem or teams wanting a private MCP registry. Works with Claude Code, Cursor, and any MCP-compatible client.

Browse more MCP tools on [TokRepo MCP Hub](https://tokrepo.com/en/@MCP%20Hub).

---

## MCP.so — Open-Source MCP Server Directory

### What It Is

MCP.so is the largest community-driven directory for Model Context Protocol servers. The entire platform is open-source, so you can self-host your own version to build an internal MCP registry for your organization.

### Tech Stack

- **Frontend:** Next.js + TypeScript + Tailwind CSS
- **Database:** Supabase (PostgreSQL)
- **Package Manager:** pnpm
- **Deployment:** Vercel-compatible

### Setup Guide

```bash
# 1. Clone the repository
git clone https://github.com/chatmcp/mcp-directory.git
cd mcp-directory

# 2. Install dependencies
pnpm install

# 3. Set up Supabase
# Create a Supabase project at supabase.com
# Run the SQL from data/install.sql in your Supabase dashboard

# 4. Configure environment
cp .env.example .env
# Edit .env with your Supabase credentials

# 5. Start development
pnpm dev
```

### Key Features

- **Searchable directory** — full-text search across all registered MCP servers
- **Community submissions** — anyone can submit new MCP servers
- **Categories and tags** — organized browsing by use case
- **Server details** — installation instructions, capabilities, and compatibility info
- **Responsive UI** — works on desktop and mobile
- **Self-hostable** — deploy your own private MCP registry

### Use Cases

1. **Internal team registry** — catalog your organization's custom MCP servers
2. **Discovery platform** — help developers find the right MCP server for their needs
3. **Learning resource** — browse server implementations to learn MCP patterns

### FAQ

**Q: What is MCP.so?**
A: MCP.so is an open-source directory for discovering and sharing Model Context Protocol (MCP) servers. It powers the public directory at mcp.so and can be self-hosted.

**Q: Is MCP.so free to use?**
A: Yes, both the hosted version at mcp.so and the open-source code are free. Licensed under Apache-2.0.

**Q: Can I self-host MCP.so?**
A: Yes, clone the repo, set up a Supabase database, and deploy to Vercel or any Node.js hosting. Full setup takes about 15 minutes.

---

## Source & Thanks

> Created by [idoubi](https://bento.me/idoubi). Licensed under Apache-2.0.
>
> [chatmcp/mcpso](https://github.com/chatmcp/mcpso) — ⭐ 2,000+

Thanks to idoubi for building the go-to directory for the MCP ecosystem.

---

<!-- ZH -->

## 快速使用

1. 克隆并安装：
```bash
git clone https://github.com/chatmcp/mcp-directory.git
cd mcp-directory
pnpm install
```

2. 配置 Supabase 数据库和 `.env` 环境变量

3. 启动开发服务器：
```bash
pnpm dev
```

---

## 简介

MCP.so 是驱动 [mcp.so](https://mcp.so) 的开源 MCP 服务器目录，GitHub 2,000+ star。基于 Next.js + Supabase + Tailwind CSS 构建，支持浏览、搜索和提交社区 MCP 服务器。适合构建自己 MCP 生态的开发者或需要私有 MCP 注册表的团队。

---

## MCP.so — 开源 MCP 服务器目录

### 技术栈

- Next.js + TypeScript + Tailwind CSS
- Supabase (PostgreSQL)
- pnpm 包管理

### 核心功能

- **全文搜索** — 跨所有 MCP 服务器搜索
- **社区提交** — 任何人都可以提交新的 MCP 服务器
- **分类浏览** — 按使用场景组织
- **可自托管** — 部署你自己的私有 MCP 注册表

### FAQ

**Q: MCP.so 是什么？**
A: 一个开源的 MCP 服务器发现和分享目录，驱动 mcp.so 公共目录。

**Q: 可以自托管吗？**
A: 可以，克隆代码、配置 Supabase、部署到 Vercel 即可，约 15 分钟完成。

---

## 来源与感谢

> Created by [idoubi](https://bento.me/idoubi). Licensed under Apache-2.0.
>
> [chatmcp/mcpso](https://github.com/chatmcp/mcpso) — ⭐ 2,000+


---
Source: https://tokrepo.com/en/workflows/a3e80e57-33ca-11f1-9bc6-00163e2b0d79
Author: AI Open Source