Simple Server

🚀 歌劇萬花筒 MCP 服務器

歌劇萬花筒 MCP 服務器提供豐富的 JSON 數據集訪問權限，其數據來源於 歌劇萬花筒 項目。該項目是一個全面的內容庫，在遊戲、敘事和機器人開發等領域具有重要價值。

🚀 快速開始

本服務器能讓你輕鬆訪問各類數據集，為你的開發工作提供有力支持。下面為你介紹使用前的準備工作。

✨ 主要特性

• 可訪問所有歌劇萬花筒數據集。
• 能隨機從數據集中進行選擇。
• 支持根據條件篩選數據集。
• 可以組合多個數據集。
• 可使用模板生成創意內容。

📦 安裝指南

1. 克隆此倉庫。
2. 安裝依賴：

npm install

3. 構建項目：

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"
  }
});