金大哥 - simple-server MCP 详情

article

README

🚀 歌剧万花筒 MCP 服务器

歌剧万花筒 MCP 服务器提供丰富的 JSON 数据集访问权限，其数据来源于歌剧万花筒项目。该项目是一个全面的内容库，在游戏、叙事和机器人开发等领域具有重要价值。

🚀 快速开始

本服务器能让你轻松访问各类数据集，为你的开发工作提供有力支持。下面为你介绍使用前的准备工作。

✨ 主要特性

可访问所有歌剧万花筒数据集。
能随机从数据集中进行选择。
支持根据条件筛选数据集。
可以组合多个数据集。
可使用模板生成创意内容。

📦 安装指南

克隆此仓库。
安装依赖：

npm install

构建项目：

npm run build

💻 使用示例

运行服务器

npm start

MCP 配置

在您的 MCP 设置文件中添加以下内容：

{
  "mcpServers": {
    "opera-omnia": {
      "command": "node",
      "args": ["path/to/opera-omnia-mcp/build/index.js"],
      "disabled": false,
      "autoApprove": []
    }
  }
}

请将 path/to/opera-omnia-mcp 替换为该项目的实际路径。

基础用法

以下为你展示本服务器可用工具的基本使用方法。

list_categories

列出所有可用的数据类别。

const result = await use_mcp_tool({
  server_name: "opera-omnia",
  tool_name: "list_categories",
  arguments: {}
});

list_datasets

列出特定类别中的所有数据集。

const result = await use_mcp_tool({
  server_name: "opera-omnia",
  tool_name: "list_datasets",
  arguments: {
    category: "characters"
  }
});

get_dataset

获取特定数据集的完整内容。

const result = await use_mcp_tool({
  server_name: "opera-omnia",
  tool_name: "get_dataset",
  arguments: {
    category: "characters",
    dataset: "personalities"
  }
});

get_random_item

从特定数据集中获取一个随机项。

const result = await use_mcp_tool({
  server_name: "opera-omnia",
  tool_name: "get_random_item",
  arguments: {
    category: "characters",
    dataset: "personalities"
  }
});

get_filtered_items

根据特定条件从数据集中获取匹配项。

const result = await use_mcp_tool({
  server_name: "opera-omnia",
  tool_name: "get_filtered_items",
  arguments: {
    category: "characters",
    filter: "age>25"
  }
});

get_related_datasets

获取与特定数据集相关的其他数据集。

const result = await use_mcp_tool({
  server_name: "opera-omnia",
  tool_name: "get_related_datasets",
  arguments: {
    category: "characters",
    dataset: "personalities"
  }
});

simple-server