MCPverse

MCPverse

这是什么？

查找不同 Model Context Protocol（MCP）服务的设置说明和配置详情（例如环境变量）可能很困难。本项目旨在解决这一问题。

它提供一份集中、简洁的优质 MCP 服务列表（mcpverse.json），其中包含：

• 易于查找的设置说明。
• 清晰的必需变量信息。
• 官方文档链接。

功能

• 简洁的数据： 服务信息存储在 mcpverse.json 中。
• 网页： 在本地打开 index.html，即可浏览服务。
• NPM 包： 在 JavaScript/Node.js 项目中使用这些数据。

通过 npm 安装

npm install mcpverse 
# or
yarn add mcpverse

如何使用（JavaScript / Node.js）

通过 npm 安装后，可以在代码中引入注册表：

// Import the registry functions
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 full details for a specific MCP ---
const puppeteerDetails = mcpverse.getMcp('puppeteer');
if (puppeteerDetails) {
    console.log("\nPuppeteer Details:", JSON.stringify(puppeteerDetails, null, 2));
}

// --- Example 3: Get required variables for Slack ---
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: Comma-separated list of Slack channel IDs to monitor.


// --- Example 4: Generate the full install command for Supabase ---
// Imagine you have your token in an environment variable
const myToken = process.env.SUPABASE_ACCESS_TOKEN || 'your-token-placeholder';

const supabaseCommand = mcpverse.generateFullCommand('supabase', { 
    SUPABASE_ACCESS_TOKEN: myToken 
});

if (supabaseCommand) {
    console.log("\nTo run Supabase MCP Server:");
    console.log(supabaseCommand);
}
// Example Output:
// To run Supabase MCP Server:
// npx -y @supabase/mcp-server-supabase@latest --access-token "your-token-placeholder"

请参阅 index.js，了解所有可用函数。

Web 界面

克隆此仓库后，可以直接在 Web 浏览器中打开 index.html 文件。它会从 mcpverse.json 加载数据，并为每个服务显示一张卡片，其中包含详细信息、安装命令和必需变量。

数据格式（mcpverse.json）

注册表是一个 JSON 对象。每个键都是一个服务 ID（例如 "prisma"），对应的值是描述该服务的对象：

{
  "id": "string",         // Unique ID (same as key)
  "name": "string",       // Display name
  "description": "string", // What it does
  "official": "boolean",  // Is it official?
  "category": "string",   // e.g., "Database"
  "readmeUrl": "string | null", // Link to docs
  "brand": {
    "logoUrl": "string | null" // Logo image URL
  },
  "installation": {
    "type": "string",       // How to install (e.g., "npx")
    "command": "string",    // Base command (e.g., "npx")
    "args": ["string"],   // Command arguments (use <VAR_NAME> for placeholders)
    "variables": {        // Optional: Required variables
      "VAR_NAME": {
        "description": "string",
        "secret": "boolean",   // Is it sensitive?
        "placeholder": "string | null" // Example format
      }
    }
  }
}

贡献

想要添加或更新服务？

1. Fork 此仓库。
2. 编辑 mcpverse.json（添加或更新条目，并遵循格式）。
3. 创建 Pull Request。

请确保添加的服务稳定且文档完善。