MCPverse

MCPverse

これは何ですか？

さまざまな Model Context Protocol（MCP）サーバーのセットアップ手順や設定の詳細（環境変数など）を見つけるのは難しい場合があります。このプロジェクトは、その問題を解決します。

品質の高い MCP サーバーの一覧を、シンプルな中央リスト（mcpverse.json）として提供します。

• セットアップ手順を簡単に見つけられます。
• 必要な変数について明確に確認できます。
• 公式ドキュメントへのリンクがあります。

機能

• シンプルなデータ： サーバー情報は mcpverse.json に保存されています。
• Web ページ： index.html をローカルで開くと、サーバーを閲覧できます。
• NPM パッケージ： JavaScript／Node.js プロジェクトでデータを使用できます。

npm でインストール

npm install mcpverse 
# or
yarn add mcpverse

使い方（JavaScript／Node.js）

npm でインストールしたら、コード内でレジストリを require できます。

// 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 インターフェース

このリポジトリをクローンすると、index.html ファイルを Web ブラウザーで直接開けます。このファイルは 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. このリポジトリを フォーク します。
2. mcpverse.json を 編集 します（エントリーを追加／更新し、形式に従ってください）。
3. プルリクエストを作成 します。

追加するサーバーが安定しており、適切なドキュメントがあることを確認してください。