opc-mcp

# OPC-MCP 订单中心数据库 MCP 服务，通过 MCP 协议暴露数据库查询能力，供 AI 助手动态查询和排查订单问题。 ## 功能特性 - **配置驱动工具** — 在 `config.yaml` 中定义 SQL 模板，自动生成 MCP 工具 - **`run_query`** — 动态执行任意 SELECT 查询，支持命名参数、LIKE 自动检测、分页 - **`query_table_desc`** — 查询表结构信息（列名、数据类型、注释），表名大小写不敏感 - **PrefabSQL 工具集** — SQL 代码双向溯源（sqlId ↔ 表名） - **多连接池** — 支持多个数据库（opc、smc 等），连接池名称大小写不敏感 - **多驱动支持** — 支持 OceanBase MySQL 模式 (`ob_mysql`) 和 Oracle 模式 (`ob_oracle`) - **安全防护** — 仅允许 SELECT 语句，拒绝多语句注入，参数化查询 --- ## 环境要求 | 驱动模式 | 依赖要求 | | ------------- | ----------------------------------- | | `ob_mysql` | Python 3.11+，无需额外依赖 | | `ob_oracle` | Python 3.11+**+ Java JDK 9+** | > ⚠️ **重要提示**：使用 `ob_oracle` 驱动连接 OceanBase Oracle 模式租户时，必须安装 Java JDK 9 或更高版本。这是因为 Oracle 模式使用 jaydebeapi + JDBC 驱动，需要 Java 运行环境。 ### 验证 Java 环境 ```bash java -version # 应显示 9 或更高版本，如：openjdk version "11.0.x" ``` --- ## 安装 ### 方式一：uvx 直接运行（推荐） ```bash # 直接运行，无需安装；首次运行自动下载并缓存 uvx opc-mcp --config /path/to/config.yaml ``` ### 方式二：uv tool 安装（需要全局命令时） ```bash # 安装到 uv 工具环境，提供全局 opc-mcp 命令 uv tool install opc-mcp # 启动服务 opc-mcp --config /path/to/config.yaml ``` ### 方式三：pip 安装 ```bash pip install opc-mcp opc-mcp --config /path/to/config.yaml ``` ### 方式四：本地开发安装 ```bash git clone https://gitee.com/zhouxinhai/opc-mcp.git cd opc-mcp uv sync uv run opc-mcp --config config.yaml ``` ### 安装方式对比 | 安装方式 | 启动命令 | 适用场景 | 对应更新方式（见下节） | | -------- | ----------------------- | ---------------------------- | -------------------------------- | | uvx | `uvx opc-mcp` | 临时运行、快速体验 | `@latest` / `==版本` / `--refresh` | | uv tool | `opc-mcp` | 日常使用，全局命令 | `uv tool upgrade` / `--force` | | pip | `opc-mcp` | 无 uv 环境 | `pip install --upgrade` | | 本地开发 | `uv run opc-mcp` | 二次开发、调试 | `git pull` + `uv…