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