MCP

🚀 Omilia MCP Tools

このリポジトリには、Omilia Cloud Platform (OCP) を操作するための一連のツールが含まれています。これらのユーティリティは、ミニアプリ、オーケストレーターアプリ、およびダイアログログの管理に役立ちます。

🚀 クイックスタート

このツールを使用することで、Omilia Cloud Platform (OCP) 上のミニアプリ、オーケストレーターアプリ、およびダイアログログを効率的に管理することができます。

✨ 主な機能

ツールの概要

• search_miniapps：名前またはキーワードでミニアプリを検索します。
• get_miniapp：特定のミニアプリのIDを使用して詳細を取得します。
• set_miniapp_prompt：ミニアプリのプロンプト（歓迎メッセージ、エラーメッセージ、反応メッセージ）を更新します。
• get_dialog_logs：特定のダイアログセッションのログを取得します。
• search_orchestrator_apps：キーワードでオーケストレーターアプリを検索します。
• get_orchestrator_app：オーケストレーターアプリのIDを使用してキャンバス（ノードとエッジ）を取得します。
• search_dialog_logs：さまざまなフィルター（日付、アプリ、リージョンなど）でダイアログログを検索します。
• search_numbers：オプションの検索用語で電話番号を検索します。
• search_variable_collections：オプションの検索用語で変数コレクションを検索します。
• get_collection_variables：IDでコレクション内のすべての変数のリストを取得します。

📦 インストール

• Python 3.10 以上がインストールされていることを確認してください。
• uv をインストールします。
• このリポジトリをクローンし、プロジェクトディレクトリに移動します。
• .env.example ファイルを .env にコピーし、適切な値を設定します。
• uv run mcp dev src/main.py を実行してインストールが正しく行われたことをテストします。これにより、mcp開発サーバーが開きます。接続をクリックして試してみてください。

💻 使用例

これらのツールは、主に2つの方法で使用できます。

1. セルフホスティング (MCP Python SDK)

公式のPython MCP SDK を使用して独自のMCPサーバーを実行することができます。これは最も柔軟なオプションで、上級ユーザーにおすすめです。詳細な手順については、MCP Python SDK README を参照してください。

2. Gemini CLI、Cursor、またはClaude Desktopでのローカル使用

このプロジェクトは、Gemini CLI、Cursor、Claude Desktopなど、MCP互換のクライアントでローカルで使用することもできます。

• Gemini CLI
• Cursor
• Claude Desktop

これらの各クライアントを使用すると、ローカルのMCPサーバーに接続できます。詳細については、それぞれのドキュメントを参照してください。

• Gemini CLI: カスタムMCPサーバーの設定
• Claude Desktop: MCPサーバー
• Cursor: カスタムMCPサーバーの設定

MCPサーバーの設定

上記のクライアントでこのプロジェクトを使用するには、MCPサーバーを設定する必要があります。たとえば、次の mcp.json 設定を使用できます（クライアントの適切な設定ディレクトリに配置します）。

{
  "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>"
      }
    }
  }
}