iflow-mcp_kutsushitaneko_mcp-server-for-oracle-database

# MCP Server for Oracle Database（極めて実験的） Oracle Database用のMCP（Model Context Protocol）サーバーの実験的な実装です。このサーバーは、AIアプリケーションがOracle Databaseに対してSQLクエリを実行し、その結果を取得するためのものです。MCPサーバーはローカルで実行されます。Cursor や Cline などの MCP クライアントから呼び出してシームレスなデータベース体験を提供することを目指してます。 ## 機能 - Oracle DatabaseへのSQLクエリ実行 - テーブル構造の取得 - セキュリティ対策（クエリ長制限、危険なキーワードチェック） - 最小限のセキュリティ対策のみ施されています。外部からアクセスできないローカルな環境でのみ使用してください。 - 結果のフォーマット機能（LLMに呼んでもらうものなので、余計なことをしているかも） ## 必要条件 - Python 3.11以上 - Oracle Databaseへのアクセス権限 - 必要な環境変数の設定（.envファイル） - uv（高速なPythonパッケージマネージャー） ※テストは、Windows 11 のみで行っています。Linux/Mac の場合は、ディレクトリパスの表記などは適宜読み替えてください。 ## セットアップ 1. リポジトリをクローン: ```bash git clone [repository-url] cd mcp-server-for-oracle-database ``` 2. 仮想環境を作成して有効化: ```bash uv venv .venv ``` ```bash:Python仮想環境の有効化（Linux/Mac/Windows の gitbash など） source .venv/bin/activate ``` ```PowerShell:Python仮想環境の有効化（Windows PowerShell） .venv\Scripts\activate ``` 3. 依存パッケージをインストール: ```bash uv pip install -r requirements.txt ``` 4. 環境変数の設定: `.env`ファイルを作成し、以下の情報を設定: ``` ORACLE_USER=your_username ORACLE_PASSWORD=your_password ORACLE_DSN=your_dsn ``` ## 提供されるツール ### execute_oracle SQLクエリ（SELECT文のみ）を実行し、結果をフォーマットして返します。 - パラメータ: - query: SQLクエリ（SELECT文のみ） - params: バインド変数 - max_length: 応答の最大文字数 - max_rows: 取得する最大行数 ※LLMがパラメータの使い方を試行錯誤することが多いようです。クライアントへパラメータの使い方を上手く伝える方法があったら教えてください。 ※読むのは LLM なのでフォーマットは余計かもしれません。 ### list_tables データベースのテーブル一覧を表示します。 - パラメータ: - max_rows: 取得する最大テーブル数（integer型、デフォルト: 50） - name_pattern: テーブル名のパターン（例: '%EMP%'）（オプション） - order_by: 並び順（'TABLE_NAME'または'CREATED'、デフォルト: 'TABLE_NAME'） - include_system_tables: システムテーブルを含めるかどうか（デフォルト: False） - use_all_tables: ALL_TABLESを参照するかどうか（デフォルト: False） - owner: テーブルの所有者（use_all_tablesがTrueの場合は必須） ### describe_table テーブルの構造を表示します。sqlplus の describe を模しています。 - パラメータ: - table_name: テーブル名 ### oracle_query_assistant execute_oracle（Oracle Databaseへのクエリ実行）をガイドするプロンプトを返します。 - パラメータ - query_type: SQL のタイプ（現在は、"select"のみ） ## 使用方法 ### MCPクライアン…