OracleDB MCP サーバー

概要

• このプロジェクトでは、構成された Oracle データベース テーブル/列を LLM のコンテキストとして提供するMCP - Model Context Protocol Serverをインストールします。

• これを使用すると、LLM が Oracle データベースと対話し、SQL 文を生成し、LLM プロンプトを使用して結果を返すことができるようになります。

インストール

• パッケージをインストールする

  pip install oracledb_mcp_server

• Oracle DB Connection Stringの最小値を含むフォルダに.envを作成します。サンプルファイルはこちらから入手できます。

• 上記のフォルダーからuv run oracledb_mcp_serverを使用してoracledb_mcp_serverサーバーをテストします。

クロードデスクトップ

• Claud Desktop の設定詳細

  { "mcpServers": { "oracledb_mcp_server":{ "command": "uv", "args": ["run","oracledb_mcp_server"], "env": { "DEBUG":"True", "COMMENT_DB_CONNECTION_STRING":"oracle+oracledb://USERNAME:PASSWORD@IP:PORT/?service_name=SERVICENAME", "DB_CONNECTION_STRING":"oracle+oracledb://USERNAME:PASSWORD@IP:PORT/?service_name=SERVICENAME", "TABLE_WHITE_LIST":"ACCOUNTS,CUS_ACC_RELATIONS,CUSTOMERS", "COLUMN_WHITE_LIST":"ACCOUNTS.ACC_AAD_ID,CUS_ACC_RELATIONS.CAR_CUS_ID,CUS_ACC_RELATIONS.CAR_AAD_ID,CUSTOMERS.CUS_ID" } } } }

構成

• 利用可能な環境変数のリスト

  • DEBUG : デバッグログを有効にする（オプション、デフォルトはFalse）

  • COMMENT_DB_CONNECTION_STRING : コメント用の Oracle DB 接続文字列。(必須)

  • DB_CONNECTION_STRING : クエリ実行用の Oracle DB 接続文字列。(必須)

  • TABLE_WHITE_LIST : ホワイトリストに登録されたテーブル名のリスト形式 ["table1", "table2"] (必須)

  • COLUMN_WHITE_LIST : ホワイトリストに登録されたテーブル列名（リスト形式 ["table.column1", "table.column2"]）（必須）

  • QUERY_LIMIT_SIZE : 指定されていない場合のデフォルト値は 10 レコードです (オプションのデフォルトは 10)

インターセプター

貢献

貢献を歓迎します。
お気軽にプルリクエストを送信してください。

ライセンス

このプロジェクトは、MIT ライセンスの条件に基づいてライセンスされます。

デモ

Githubスター