MCPDir

v1.0.0Developer Toolsstable

The largest open MCP server directory — 8,000+ community-driven Model Context Protocol servers. Open-source, fully searchable.

aiai-agentai-agentsclaudedeveloper-tools
Share:
9
Stars
0
Downloads
0
Weekly
0/5

What is MCPDir?

MCPDir is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to largest open mcp server directory — 8,000+ community-driven model context protocol servers. open-source, fully searchable.

The largest open MCP server directory — 8,000+ community-driven Model Context Protocol servers. Open-source, fully searchable.

This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • The largest open MCP server directory — 8,000+ community-dri

Use Cases

Search 8,000+ community MCP servers
Discover open-source integrations
eL1fe

Maintainer

LicenseMIT
Languagetypescript
Versionv1.0.0
UpdatedMay 15, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx mcpdir

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use MCPDir

MCPDir is an open-source directory platform aggregating over 8,000 community-driven Model Context Protocol servers from five sources: the official MCP Registry, npm packages, GitHub repositories, Glama.ai, and PulseMCP. It provides full-text PostgreSQL search with trigram matching, category browsing across 15+ categories, and Docker-based validation with real MCP handshake verification.

Prerequisites

  • Node.js 20 or higher
  • pnpm 9 or higher (install with: npm install -g pnpm)
  • PostgreSQL database (Neon serverless PostgreSQL is recommended for easy setup)
  • GitHub OAuth App credentials for user authentication
  • Optional: Anthropic or OpenRouter API key for AI-enhanced server parsing
1

Clone the repository and install dependencies

Clone the MCPDir project and install all Node.js dependencies using pnpm.

git clone https://github.com/eL1fe/mcpdir.git
cd mcpdir
pnpm install
2

Configure environment variables

Create a .env.local file with your database connection string, GitHub OAuth credentials, and optional AI API keys.

DATABASE_URL=postgresql://user:password@host/dbname
GITHUB_TOKEN=ghp_your_github_token
GITHUB_CLIENT_ID=your_github_oauth_client_id
GITHUB_CLIENT_SECRET=your_github_oauth_client_secret
AUTH_SECRET=$(openssl rand -hex 32)
ANTHROPIC_API_KEY=sk-ant-...  # optional
OPENROUTER_API_KEY=sk-or-...  # optional
3

Initialize the database

Generate the database schema with Drizzle ORM, push it to your PostgreSQL instance, and seed the initial category data.

pnpm db:generate
pnpm db:push
pnpm seed:categories
4

Synchronize MCP server data

Sync the MCP server registry from all configured data sources. Use 'sync:all' to populate from all five sources on first run.

pnpm sync          # Official MCP Registry only
pnpm sync:all      # All five sources (recommended for first run)
pnpm sync:force    # Force full refresh of all servers
5

Start the development server

Launch the Next.js development server. The platform will be available at http://localhost:3000.

pnpm dev
6

Validate MCP servers with Docker

Run Docker-based validation to verify that the most popular MCP servers actually respond to MCP handshakes. This requires Docker to be running.

pnpm validate:popular

MCPDir Examples

Client configuration

MCPDir is a web directory platform, not itself an MCP server. Run it as a Next.js app and access it via browser.

# Start the platform
pnpm dev
# Open http://localhost:3000 in your browser

# Access the database management UI
pnpm db:studio

Prompts to try

Use MCPDir's search interface to discover MCP servers for your use case.

- Search for "filesystem" to find file management MCP servers
- Browse the "Developer Tools" category for coding assistant integrations
- Search for "database" to find SQL and NoSQL MCP integrations
- Filter by "verified" to see Docker-validated servers only

Troubleshooting MCPDir

Database connection fails during setup

Verify that DATABASE_URL uses the correct PostgreSQL connection string format: postgresql://user:password@host:5432/dbname. For Neon, copy the connection string directly from the Neon dashboard and ensure SSL mode is appended: ?sslmode=require.

GitHub OAuth login not working

Ensure your GitHub OAuth App's Authorization callback URL is set to http://localhost:3000/api/auth/callback/github for local development. The GITHUB_CLIENT_ID and GITHUB_CLIENT_SECRET must match the OAuth App settings in your GitHub account.

Sync command returns empty results

Check that GITHUB_TOKEN is set and has read access to public repositories (no special scopes needed). The token is used to avoid GitHub API rate limits during the sync process. Run 'pnpm sync:all' with the token set to verify.

Frequently Asked Questions about MCPDir

What is MCPDir?

MCPDir is a Model Context Protocol (MCP) server that largest open mcp server directory — 8,000+ community-driven model context protocol servers. open-source, fully searchable. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install MCPDir?

Follow the installation instructions on the MCPDir GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with MCPDir?

MCPDir works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is MCPDir free to use?

Yes, MCPDir is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Browse More Developer Tools MCP Servers

Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "mcpdir": { "command": "npx", "args": ["-y", "mcpdir"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use MCPDir?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides