Simple Server

🚀 Opera Omnia MCP Server

An MCP server that provides access to a rich JSON dataset from the Opera Omnia project, a comprehensive content library suitable for game, narrative, and robotics development.

🚀 Quick Start

This Opera Omnia MCP Server offers a convenient way to access a wide range of JSON datasets, which can be very useful for various development projects.

✨ Features

• Access all Opera Omnia datasets.
• Randomly select from the datasets.
• Filter datasets based on conditions.
• Combine multiple datasets.
• Generate creative content using templates.

📦 Installation

1. Clone this repository.
2. Install dependencies:

npm install

3. Build the project:

npm run build

💻 Usage Examples

Basic Usage

Run the server

npm start

MCP Configuration

Add the following content to your MCP settings file:

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

Replace path/to/opera-omnia-mcp with the actual path of this project.

Advanced Usage

list_categories

List all available data categories.

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

list_datasets

List all datasets in a specific category.

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

get_dataset

Get the full content of a specific dataset.

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

get_random_item

Get a random item from a specific dataset.

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

get_filtered_items

Get matching items from a dataset based on specific conditions.

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

get_related_datasets

Get other datasets related to a specific dataset.

const result = await use_mcp_tool({
  server_name: "opera-omnia",
  tool_name: "get_related_datasets",
  // Add specific arguments here if needed
});