Oracle Mcp Lite

io.github.bluegemsk由 GitHub 账号 bluegemsk 发布v0.1.1更新于 Oct 29, 2026

Offline Oracle AWR/ASH report analyzer with DBA tuning advice and a top-3 tuning summary.

已验证STDIO仅桌面数据库数据与分析

概览

AI 生成的概览

离线分析 Oracle AWR/ASH 报告的 MCP 服务器,返回等待事件、Top SQL 与按优先级排序的 DBA 调优建议。

可以做什么
  • 解析提供的 AWR 或 ASH 报告(HTML 或文本,Oracle 10g–23ai,单实例或 RAC 全局),识别报告类型与数据库版本
  • 汇总平均活动会话数、负载概况、Top 等待事件与 Top SQL
  • 为每项发现附上简短的、随版本变化的 DBA 调优建议
  • 生成按优先级排序的前三项调优摘要,指出应先处理什么
适用场景
当你手头有 Oracle AWR 或 ASH 报告文件,希望助手解读报告并给出调优切入点,且不想连接数据库或把报告传出本机时适用。
运行要求
需在本机用 pip 安装 Python 包 oracle-mcp-lite,并以 stdio 方式运行 MCP 服务器。无需 Oracle 客户端、数据库连接、账号、API 密钥或环境变量;报告文件需位于本机可访问路径。
安装前请注意
报告在本地分析、不会上传,但其中包含 SQL 文本、schema 与负载细节,请妥善保管文件与助手输出。建议属于启发式参考,不能替代 DBA 审核。含 PL/SQL 审查、DDL 检查与 Data Pump 检查的完整版为另一产品。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Oracle Mcp Lite,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

oracle-mcp-lite

Free, offline Oracle AWR / ASH report analyzer for AI assistants (Model Context Protocol server, MIT).

Give Claude, Cursor, Codex or any MCP client an AWR or ASH report (HTML or text, Oracle 10g–23ai, single instance or RAC global) and get back: report type and DB version, average active sessions, load profile, top wait events and top SQL — each with a short, version-aware DBA tuning advice — plus a prioritised top-3 tuning_summary. Runs locally; your reports never leave your machine. No Oracle client or database connection needed.

Full version: PL/SQL code review, DDL summary (missing PKs, unindexed FKs), Data Pump .dmp inspection and more — see https://bluegem.sk/oracle-mcp-lite.html

Install

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

Client config (Claude Desktop / Cursor / Gemini CLI):

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

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

Use

"Analyze the AWR report at /reports/awr_0900.html and tell me what to fix first."

Example tuning_summary (synthetic report):

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 ...

Development

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

Tests use synthetic fixtures only.

Not affiliated with Oracle. Oracle is a trademark of Oracle Corporation.

来源:README.md,提交 3a23154

工具

0
SourceWeft 尚未在沙箱中启动过该软件包,因此其工具未知。

版本历史

1
  1. v0.1.1最新Oct 29, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手;SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分