remote s

Remote MCP Servers provides a dynamic registry of MCP servers that you can discover, filter, and query via a public API. The registry exposes endpoints to fetch approved MCP servers, along with helper endpoints to list all categories and authentication types. You can browse servers by category, search by name or description, and apply filters such as official status, authentication type, and dynamic client registration support. Use the /api/servers endpoint to retrieve a paginated, filterable list, then drill into individual server details for maintainer contact, MCP URL, and metadata. If you’re building an app that consumes MCP servers, this registry acts as a central source of truth for discovery and to feed dynamic client registration or compatibility checks.

Prerequisites:

• Node.js v18 or later
• npm or yarn
• A Supabase project (for registry data storage and auth)

1. Clone the repository:

git clone https://github.com/portal-labs-infrastructure/remote-mcp-servers
cd remote-mcp-servers

2. Install dependencies:

npm install
# or
yarn install

3. Configure environment variables (production or local development):

• Create a .env.local file in the project root.
• Add your Supabase credentials:

NEXT_PUBLIC_SUPABASE_URL=YOUR_SUPABASE_PROJECT_URL
NEXT_PUBLIC_SUPABASE_ANON_KEY=YOUR_SUPABASE_ANON_PUBLIC_KEY
# Optional: if you use server-side actions with elevated privileges
# SUPABASE_SERVICE_ROLE_KEY=YOUR_SUPABASE_SERVICE_ROLE_KEY

4. Start the development server:

npm run dev
# or
yarn dev

The app will typically be available at http://localhost:3000.

Tips:

• The registry uses Supabase for data storage and authentication; ensure your Supabase project has the required tables and RLS configured for your use case.
• If you deploy with production settings, remember to set environment variables in your hosting environment (e.g., Vercel, Netlify, or your own server).
• The API at /api/servers supports filtering by categories, authentication types, search queries, and pagination. Use multiple authTypes or categories by comma-separated values (e.g., authTypes=OAuth,APIKey).
• When submitting new MCP servers, entries may go into a pending review workflow before appearing publicly.
• If you modify the registry schema, update the seed data and any seed scripts accordingly.