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