MCP

🚀 Omilia MCP Tools

This repository offers a suite of tools for interacting with the Omilia Cloud Platform (OCP), facilitating the management of miniapps, orchestrator apps, and dialog logs.

🚀 Quick Start

The Omilia MCP Tools provide a range of functionalities to manage various aspects of the Omilia Cloud Platform. They are designed to streamline operations related to miniapps, orchestrator apps, and dialog logs.

✨ Features

• search_miniapps: Search for miniapps by name or keyword.
• get_miniapp: Retrieve details for a specific miniapp using its ID.
• set_miniapp_prompt: Update prompts (welcome, error, reaction messages) for a miniapp.
• get_dialog_logs: Fetch logs for a specific dialog session.
• search_orchestrator_apps: Search for Orchestrator apps by keyword.
• get_orchestrator_app: Retrieve the canvas (nodes and edges) for an Orchestrator app by ID.
• search_dialog_logs: Search dialog logs with various filters (date, app, region, etc.).
• search_numbers: Search for phone numbers with optional search term.
• search_variable_collections: Search variable collections with optional search term.
• get_collection_variables: Get a list of all variables in a collection by ID.

📦 Installation

• Ensure you have Python 3.10 or a newer version installed.
• Install uv.
• Clone this repository and navigate to the project directory.
• Copy the file .env.example to .env and set the appropriate values.
• Test if the installation is correct by running uv run mcp dev src/main.py. This should open the mcp development server. Click on connect and try it out.

💻 Usage Examples

Basic Usage

You can use these tools in two main ways:

1. Self-hosting (MCP Python SDK)

You can run your own MCP server using the official Python MCP SDK. This is the most flexible option and is recommended for advanced users. For full instructions, see the MCP Python SDK README.

2. Local usage with Gemini CLI, Cursor, or Claude Desktop

You can also use this project locally with any MCP-compatible client, such as:

• Gemini CLI
• Cursor
• Claude Desktop

Each of these clients allows you to connect to local MCP servers. For more information, see their respective documentation:

• Gemini CLI: Configuring custom MCP servers
• Claude Desktop: MCP servers
• Cursor: Configuring custom MCP servers

Advanced Usage

Configuring MCP Servers

To use this project with any of the above clients, you need to configure your MCP servers. For example, you can use the following mcp.json configuration (place it in the appropriate config directory for your client):

{
  "mcpServers": {
    "Omilia MCP": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mcp",
        "mcp",
        "run",
        "<path_to_cloned_repository>>/omilia-mcp/src/main.py"
      ],
      "env": {
        "PATH": "<depending on how you installed the needed tools you may need to paste your PATH here>"
      }
    }
  }
}