Opera Omnia MCP 服务器

MCP 服务器提供对Opera Omnia项目中丰富的 JSON 数据集的访问，Opera Omnia 是一个用于游戏、讲故事和机器人开发的综合创意内容库。

特征

访问所有 Opera Omnia 数据集
从数据集中随机选择
按条件过滤数据集
合并多个数据集
使用模板生成创意内容

安装

克隆此存储库
安装依赖项：

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替换为此项目的实际路径。

可用工具

列表类别

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

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

列出数据集

列出某一类别内的所有数据集。

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

获取数据集

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

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

获取随机物品

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

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

获取过滤项目

从数据集中获取符合特定条件的项目。

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

合并数据集

组合多个数据集并获取随机选择。

const result = await use_mcp_tool({
  server_name: "opera-omnia",
  tool_name: "combine_datasets",
  arguments: {
    datasets: [
      { category: "characters", dataset: "personalities" },
      { category: "characters", dataset: "backstories" }
    ],
    count: 3
  }
});

生成内容

根据多个数据集生成创意内容。

const result = await use_mcp_tool({
  server_name: "opera-omnia",
  tool_name: "generate_content",
  arguments: {
    template: "A {adjective} {class} must {quest} to obtain {artifact}",
    datasets: {
      adjective: { category: "attributes", dataset: "adjectives" },
      class: { category: "rpg", dataset: "classes" },
      quest: { category: "situations", dataset: "quests" },
      artifact: { category: "equipment", dataset: "artifacts" }
    }
  }
});

可用资源

opera-omnia://categories

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

const result = await access_mcp_resource({
  server_name: "opera-omnia",
  uri: "opera-omnia://categories"
});

opera-omnia://category/{category}

特定类别中可用的数据集列表。

const result = await access_mcp_resource({
  server_name: "opera-omnia",
  uri: "opera-omnia://category/characters"
});

opera-omnia://数据集/{类别}/{数据集}

特定数据集的内容。

const result = await access_mcp_resource({
  server_name: "opera-omnia",
  uri: "opera-omnia://dataset/characters/personalities"
});

未来的增强功能

我们对 Opera Omnia MCP 服务器的未来增强功能有几个想法：

高级内容生成：除了简单的模板替换之外，还添加更复杂的内容生成功能。
改进的缓存：实施更好的缓存机制以提高性能，特别是对于经常访问的数据集。
用户贡献的数据集：添加对用户贡献的数据集的支持，允许用户扩展可用内容。
可视化工具：创建可视化工具来探索数据并了解不同数据集之间的关系。
本地数据文件：添加对本地数据文件的支持，作为从 GitHub 获取的替代方法。
集成示例：提供更多将 MCP 服务器与不同应用程序和框架集成的示例。

发行说明

有关当前和过去版本的详细信息，请参阅RELEASE_NOTES.md文件。

执照

该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅LICENSE.md文件。

Opera Omnia MCP Server