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。

请确保添加的服务器稳定且文档良好。