mcpField
O
oracle-mcp-lite

oracle-mcp-lite

本地服务
github.com/bluegemsk数据库01 天前更新
代码仓库

关于 oracle-mcp-lite

oracle-mcp-lite 是面向 DBA 和数据库团队的离线 MCP 服务，用于分析 Oracle AWR 和 ASH 报告。它总结数据库负载、等待事件和主要 SQL，并提供版本相关的调优建议及优先级前三项摘要；报告保留在本地。

主要功能

  1. 01分析 HTML 和文本格式的 AWR 或 ASH 报告
  2. 02识别报告类型和 Oracle 版本
  3. 03总结负载、等待事件和主要 SQL
  4. 04提供版本相关的 DBA 调优建议
  5. 05列出优先级最高的三项调优建议
  6. 06无需连接 Oracle 数据库即可本地运行

适用场景

  1. 01根据 AWR 报告排查数据库性能
  2. 02无需连接数据库即可检查 ASH 数据
  3. 03根据报告结果确定调优工作的优先级

MCP 相关

提供 MCP 服务，接收 MCP 客户端提交的 AWR 或 ASH 报告，并返回分析和调优建议。README 列出了能力，但未说明工具名称。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "bluegemsk-oracle-mcp-lite": {
      "command": "uvx",
      "args": [
        "oracle-mcp-lite"
      ]
    }
  }
}
启动命令uvx oracle-mcp-lite

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
pypioracle-mcp-lite0.1.1

工具

1

收录的工具列表 · 更新于 今天

参数类型必填说明
pathany否
contentany否

详细介绍

oracle-mcp-lite

面向 AI 助手的免费离线 Oracle AWR / ASH 报告分析器（模型上下文协议服务，MIT）。

向 Claude、Cursor、Codex 或任何 MCP 客户端提供 AWR 或 ASH 报告（HTML 或文本格式，Oracle 10g–23ai，单实例或 RAC 全局报告），即可获取：报告类型和 DB 版本、平均活动会话数、负载概况、主要等待事件和主要 SQL，以及针对每项内容的简短建议，建议会根据版本调整；还会提供按优先级排列的前三项 tuning_summary。 在本地运行；报告绝不会离开你的设备。无需 Oracle 客户端或数据库连接。

**完整版：**PL/SQL 代码审查、DDL 摘要（缺失的 PK、未建立索引的 FK）、Data Pump .dmp 检查等更多功能 — 请参阅 https://bluegem.sk/oracle-mcp-lite.html

安装

pip install oracle-mcp-lite
oracle-mcp-lite --list-tools

客户端配置（Claude Desktop / Cursor / Gemini CLI）：

{"mcpServers": {"oracle-awr": {"command": "oracle-mcp-lite"}}}

Claude Code：claude mcp add oracle-awr -- oracle-mcp-lite

使用

“分析 /reports/awr_0900.html 中的 AWR 报告，并告诉我应该先修复什么。”

示例 tuning_summary（合成报告）：

1. ARCH wait on SENDREQ (41.7%): Redo shipping to the standby is slow: check network bandwidth/latency to the
   standby and the transport mode; ASYNC transport removes it from the commit path.
2. CPU time (27.8%): Find the top SQL by CPU / buffer gets and cut logical I/O ...
3. SQL aaaaaaaaaaaa1 (25.0%): Slow per execution (1,800.0 s/exec): check the plan with DBMS_XPLAN.DISPLAY_AWR ...

开发

pip install -e '.[dev]' && pytest && python -m build

测试仅使用合成样例。

与 Oracle 无关联。Oracle 是 Oracle Corporation 的商标。

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。