{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_h422ygbnxu7q","handle":"opc-mcp","url":"https://wellknown.network/agents/opc-mcp","links":{"self":"https://wellknown.network/agents/opc-mcp/record.json","html":"https://wellknown.network/agents/opc-mcp","markdown":"https://wellknown.network/agents/opc-mcp/record.md","api":"https://wellknown.network/api/v1/agents/opc-mcp","status":"https://wellknown.network/api/v1/agents/opc-mcp/status","claim":"https://wellknown.network/agents/opc-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/opc-mcp/claim.json","badge":"https://wellknown.network/agents/opc-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:opc-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"opc-mcp","summary":"MCP server for order center database access","description":"# OPC-MCP \n \n订单中心数据库 MCP 服务，通过 MCP 协议暴露数据库查询能力，供 AI 助手动态查询和排查订单问题。 \n \n## 功能特性 \n \n- **配置驱动工具** — 在 `config.yaml` 中定义 SQL 模板，自动生成 MCP 工具 \n- **`run_query`** — 动态执行任意 SELECT 查询，支持命名参数、LIKE 自动检测、分页 \n- **`query_table_desc`** — 查询表结构信息（列名、数据类型、注释），表名大小写不敏感 \n- **PrefabSQL 工具集** — SQL 代码双向溯源（sqlId ↔ 表名） \n- **多连接池** — 支持多个数据库（opc、smc 等），连接池名称大小写不敏感 \n- **多驱动支持** — 支持 OceanBase MySQL 模式 (`ob_mysql`) 和 Oracle 模式 (`ob_oracle`) \n- **安全防护** — 仅允许 SELECT 语句，拒绝多语句注入，参数化查询 \n \n--- \n \n## 环境要求 \n \n| 驱动模式      | 依赖要求                            | \n| ------------- | ----------------------------------- | \n| `ob_mysql`  | Python 3.11+，无需额外依赖          | \n| `ob_oracle` | Python 3.11+**+ Java JDK 9+** | \n \n> ⚠️ **重要提示**：使用 `ob_oracle` 驱动连接 OceanBase Oracle 模式租户时，必须安装 Java JDK 9 或更高版本。这是因为 Oracle 模式使用 jaydebeapi + JDBC 驱动，需要 Java 运行环境。 \n \n### 验证 Java 环境 \n \n```bash \njava -version \n# 应显示 9 或更高版本，如：openjdk version \"11.0.x\" \n``` \n \n--- \n \n## 安装 \n \n### 方式一：uvx 直接运行（推荐） \n \n```bash \n# 直接运行，无需安装；首次运行自动下载并缓存 \nuvx opc-mcp --config /path/to/config.yaml \n``` \n \n### 方式二：uv tool 安装（需要全局命令时） \n \n```bash \n# 安装到 uv 工具环境，提供全局 opc-mcp 命令 \nuv tool install opc-mcp \n \n# 启动服务 \nopc-mcp --config /path/to/config.yaml \n``` \n \n### 方式三：pip 安装 \n \n```bash \npip install opc-mcp \nopc-mcp --config /path/to/config.yaml \n``` \n \n### 方式四：本地开发安装 \n \n```bash \ngit clone https://gitee.com/zhouxinhai/opc-mcp.git \ncd opc-mcp \nuv sync \nuv run opc-mcp --config config.yaml \n``` \n \n### 安装方式对比 \n \n| 安装方式 | 启动命令                | 适用场景                     | 对应更新方式（见下节）           | \n| -------- | ----------------------- | ---------------------------- | -------------------------------- | \n| uvx      | `uvx opc-mcp`           | 临时运行、快速体验           | `@latest` / `==版本` / `--refresh` | \n| uv tool  | `opc-mcp`               | 日常使用，全局命令           | `uv tool upgrade` / `--force`    | \n| pip      | `opc-mcp`               | 无 uv 环境                   | `pip install --upgrade`          | \n| 本地开发 | `uv run opc-mcp`        | 二次开发、调试               | `git pull` + `uv…","publisher":null,"homepage":"https://github.com/zhouxinhai/opc-mcp","repository":"https://github.com/zhouxinhai/opc-mcp","version":"0.2.14","license":null,"protocols":["mcp"],"tags":["mcp","database","oracle","mysql","order-center"],"pricing":null,"endpoints":[{"url":"pypi:opc-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"data.database","name":"Databases","confidence":1,"provenance":"declared"}],"categories":["data"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"opc-mcp","registry":"pypi","observedAt":"2026-09-10T08:27:40.327Z","publishedAt":"2026-09-09T09:48:18.160114Z","latestVersion":"0.2.14"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"opc-mcp","url":"https://pypi.org/project/opc-mcp/","firstSeenAt":"2026-09-10T08:26:27.212Z","fetchedAt":"2026-09-10T08:26:27.212Z","normalizedAt":"2026-09-10T08:26:27.212Z"}]},"firstSeenAt":"2026-09-10T08:26:27.212Z","updatedAt":"2026-09-10T08:27:40.327Z"}