Mcpverse

🚀 MCPverse

This project provides a simple central list (mcpverse.json) containing information about high - quality MCP servers, making it easier to find installation instructions, required variable information, and official documentation links.

🚀 Quick Start

Finding setup instructions and configuration details (such as environment variables) for different Model Context Protocol (MCP) servers can be challenging. This project addresses this issue by offering a straightforward central list (mcpverse.json) with information on quality MCP servers.

✨ Features

• Simple Data: Server information is stored in mcpverse.json.
• Web Interface: Open the local index.html to browse the servers.
• NPM Package: Use this data in JavaScript/Node.js projects.

📦 Installation

Install via npm

npm install mcpverse 
# or
yarn add mcpverse

💻 Usage Examples

Basic Usage

After installing via npm, you can import the registry in your code:

// Import the registry function
const mcpverse = require('mcpverse'); 

// Example 1: List all available MCP server names
const allMcps = mcpverse.listMcps();
console.log("Available MCPs:");
allMcps.forEach(mcp => console.log(`- ${mcp.name} (ID: ${mcp.id})`));
// Output:
// Available MCPs:
// - Prisma MCP Server (ID: prisma)
// - Puppeteer MCP Server (ID: puppeteer)
// - Slack MCP Server (ID: slack)
// - Supabase MCP Server (ID: supabase)

// Example 2: Get the full details of a specific MCP
const puppeteerDetails = mcpverse.getMcp('puppeteer');
if (puppeteerDetails) {
    console.log("\nPuppeteer details:", JSON.stringify(puppeteerDetails, null, 2));
}

// Example 3: Get the variables required for Slack's installation information
const slackInfo = mcpverse.getInstallationInfo('slack');
if (slackInfo && slackInfo.variables) {
    console.log("\nSlack requires the following variables:");
    for (const [varName, details] of Object.entries(slackInfo.variables)) {
        console.log(`- ${varName}: ${details.description}`);
    }
}
// Output:
// Slack requires the following variables:
// - SLACK_BOT_TOKEN: Your Slack bot token (starts with xoxb-).
// - SLACK_TEAM_ID: Your Slack workspace team ID (starts with T).
// - SLACK_CHANNEL_IDS: A comma - separated list of Slack channel IDs to monitor.

// Example 4: Generate a complete installation command for Supabase
// Assume you have a token in your environment variables
const myToken = process.env.SUPABASE_TOKEN || 'your-supabase-token';
mcpverse.createMCP('supabase', { token: myToken }, (error, mcp) => {
    if (error) {
        console.error('Failed to create MCP:', error);
        return;
    }
    console.log('Successfully created MCP:', mcp.id);
});

Web Interface

By cloning this repository and opening index.html, you can view all available MCP servers in a web browser.

📚 Documentation

Data Format

The mcpverse.json file contains the following fields:

{
  "servers": [
    {
      "id": "prisma",
      "name": "Prisma MCP Server",
      "description": "Server for Prisma model context protocol.",
      "documentation": "https://prisma.io/docs/mcp"
    },
    {
      "id": "puppeteer",
      "name": "Puppeteer MCP Server",
      "description": "Server for Puppeteer model context protocol.",
      "documentation": "https://puppeteer.dev/docs/mcp"
    },
    // Other servers...
  ]
}

🔧 Contribution Guide

1. Fork this repository.
2. Edit mcpverse.json (add/update entries following the format).
3. Create a Pull Request.

Please ensure that the added servers are stable and well - documented.