Mcpverse

🚀 MCPverse 中文版

本項目致力於解決查找不同模型上下文協議（MCP）服務器設置說明和配置詳細信息（如環境變量）困難的問題。它提供了一個簡單的中央列表 (mcpverse.json)，其中包含優質 MCP 服務器的信息，涵蓋易於查找的安裝說明、清晰的所需變量信息以及官方文檔鏈接。

🚀 快速開始

本項目提供了便捷的使用方式，你既可以通過 npm 安裝使用，也能借助網頁界面進行瀏覽。

✨ 主要特性

• 簡單數據：服務器信息存儲在 mcpverse.json 中。
• 網頁界面：打開本地的 index.html 即可瀏覽服務器。
• NPM 包：可在 JavaScript/Node.js 項目中使用這些數據。

📦 安裝指南

通過 npm 或 yarn 進行安裝，命令如下：

npm install mcpverse 
# 或者
yarn add mcpverse

💻 使用示例

基礎用法

通過 npm 安裝後，您可以在代碼中引入該註冊表：

// 導入註冊表函數
const mcpverse = require('mcpverse'); 

// 示例 1：列出所有可用的 MCP 服務器名稱
const allMcps = mcpverse.listMcps();
console.log("可用的 MCP:");
allMcps.forEach(mcp => console.log(`- ${mcp.name} (ID: ${mcp.id})`));
// 輸出：
// 可用的 MCP:
// - Prisma MCP 服務器 (ID: prisma)
// - Puppeteer MCP 服務器 (ID: puppeteer)
// - Slack MCP 服務器 (ID: slack)
// - Supabase MCP 服務器 (ID: supabase)

// 示例 2：獲取特定 MCP 的完整詳細信息
const puppeteerDetails = mcpverse.getMcp('puppeteer');
if (puppeteerDetails) {
    console.log("\nPuppeteer 詳細信息:", JSON.stringify(puppeteerDetails, null, 2));
}

// 示例 3：獲取 Slack 的安裝信息所需的變量
const slackInfo = mcpverse.getInstallationInfo('slack');
if (slackInfo && slackInfo.variables) {
    console.log("\nSlack 需要以下變量:");
    for (const [varName, details] of Object.entries(slackInfo.variables)) {
        console.log(`- ${varName}: ${details.description}`);
    }
}
// 輸出：
// Slack 需要以下變量:
// - SLACK_BOT_TOKEN: 您的 Slack 機器人令牌（以 xoxb- 開頭）。
// - SLACK_TEAM_ID: 您的 Slack 工作區團隊 ID（以 T 開頭）。
// - SLACK_CHANNEL_IDS: 要監視的 Slack 頻道 ID 的逗號分隔列表。

// 示例 4：為 Supabase 生成完整的安裝命令
// 假設您在環境變量中有一個令牌
const myToken = process.env.SUPABASE_TOKEN || 'your-supabase-token';
mcpverse.createMCP('supabase', { token: myToken }, (error, mcp) => {
    if (error) {
        console.error('創建 MCP 失敗:', error);
        return;
    }
    console.log('成功創建 MCP:', mcp.id);
});

高級用法

通過克隆此倉庫並打開 index.html，您可以在網頁瀏覽器中查看所有可用的 MCP 服務器。

📚 詳細文檔

數據格式

mcpverse.json 文件包含以下字段：

{
  "servers": [
    {
      "id": "prisma",
      "name": "Prisma MCP 服務器",
      "description": "用於 Prisma 模型上下文協議的服務器。",
      "documentation": "https://prisma.io/docs/mcp"
    },
    {
      "id": "puppeteer",
      "name": "Puppeteer MCP 服務器",
      "description": "用於 Puppeteer 模型上下文協議的服務器。",
      "documentation": "https://puppeteer.dev/docs/mcp"
    },
    // 其他服務器...
  ]
}

貢獻指南

1. Fork 此倉庫。
2. 編輯 mcpverse.json（添加/更新條目，遵循格式）。
3. 創建 Pull Request。

請確保添加的服務器穩定且文檔良好。