oracle-mcp-lite について
oracle-mcp-liteは、DBAやデータベースチーム向けにOracle AWRおよびASHレポートを分析するオフラインMCPサーバーです。データベース負荷、待機イベント、主要SQLを要約し、バージョンに応じた調整案と優先度上位3件を提示します。レポートはローカルに保持されます。
主な機能
- 01HTMLおよびテキスト形式のAWR・ASHレポートを分析
- 02レポート種別とOracleバージョンを特定
- 03負荷、待機イベント、主要SQLを要約
- 04バージョンに応じたDBA向け調整案を提示
- 05優先度上位3件の調整案を提示
- 06Oracle接続なしでローカル実行
活用シーン
- 01AWRレポートを使ったデータベース性能の調査
- 02データベースに接続せずASHデータを確認
- 03レポート結果から調整作業の優先順位を決定
MCP 対応
MCPクライアントからAWRまたはASHレポートを受け取り、分析と調整案を返すMCPサーバーを提供します。READMEには機能が記載されていますが、ツール名は示されていません。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
1掲載時のツール一覧 · 今日に更新
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| path | any | いいえ | |
| content | any | いいえ |
詳細
oracle-mcp-lite
AI アシスタント向けの無料・オフライン対応 Oracle AWR / ASH レポートアナライザー(Model Context Protocol サーバー、MIT ライセンス)です。
AWR または ASH レポート(HTML またはテキスト、Oracle 10g~23ai、単一インスタンスまたは RAC グローバル)を Claude、Cursor、Codex、または任意の MCP クライアントに渡すと、レポートの種類と DB バージョン、平均アクティブセッション数、負荷プロファイル、上位の待機イベントと上位 SQL が返されます。それぞれに、バージョンに応じた簡潔な DBA チューニングのアドバイスも含まれます。さらに、優先順位付きの上位 3 項目からなる tuning_summary も返されます。
ローカルで動作するため、レポートがマシンの外に送信されることはありません。Oracle クライアントやデータベース接続は不要です。
完全版: PL/SQL コードレビュー、DDL の概要(主キーの欠落、インデックスのない外部キー)、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 の商標です。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。