MCP

🚀 Omilia MCP 工具集

本倉庫包含一套用於與 Omilia 雲平臺（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 開發服務器。點擊連接並進行測試。

💻 使用示例

你可以通過以下兩種主要方式使用這些工具：

1. 自託管（MCP Python SDK）

你可以使用 官方 Python MCP SDK 運行自己的 MCP 服務器。這是最靈活的選項，建議高級用戶使用。完整說明請參閱 MCP Python SDK README。

2. 在本地與 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>"
      }
    }
  }
}