Opera Omnia MCP Server

An MCP server that provides access to the rich collection of JSON datasets from the Opera Omnia project, a comprehensive library of creative content for games, storytelling, and bot development.

Features

• Access to all Opera Omnia datasets

• Random selection from datasets

• Filtering datasets by criteria

• Combining multiple datasets

• Generating creative content using templates

Related MCP server: Chroma MCP Server

Installation

1. Clone this repository

2. Install dependencies:

3. Build the project:

Usage

Running the Server

MCP Configuration

Add the following to your MCP settings file:

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

Available Tools

list_categories

List all available data categories.

list_datasets

List all datasets within a category.

get_dataset

Get the complete contents of a specific dataset.

get_random_item

Get a random item from a specific dataset.

get_filtered_items

Get items from a dataset that match specific criteria.

combine_datasets

Combine multiple datasets and get random selections.

generate_content

Generate creative content based on multiple datasets.

Available Resources

opera-omnia://categories

List of all available data categories.

opera-omnia://category/{category}

List of datasets available in a specific category.

opera-omnia://dataset/{category}/{dataset}

Contents of a specific dataset.

Future Enhancements

We have several ideas for future enhancements to the Opera Omnia MCP server:

1. Advanced Content Generation: Add more sophisticated content generation capabilities beyond simple template substitution.

2. Improved Caching: Implement better caching mechanisms for improved performance, especially for frequently accessed datasets.

3. User-Contributed Datasets: Add support for user-contributed datasets, allowing users to extend the available content.

4. Visualization Tools: Create visualization tools for exploring the data and understanding relationships between different datasets.

5. Local Data Files: Add support for local data files as an alternative to fetching from GitHub.

6. Integration Examples: Provide more examples of integrating the MCP server with different applications and frameworks.

Release Notes

For detailed information about the current and past releases, see the RELEASE_NOTES.md file.

License

This project is licensed under the MIT License - see the LICENSE.md file for details.