OracleDB MCP Server

OracleDB MCP サーバー

概要

• このプロジェクトでは、設定した Oracle Database のテーブル／列を LLM のコンテキストとして提供する MCP - Model Context Protocol Server をインストールします。
• これを使用すると、LLM が Oracle Database とやり取りし、SQL ステートメントを生成して、LLM のプロンプトを使って結果を返せるようになります。

インストール

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

  pip install oracledb_mcp_server
  

• Oracle DB Connection String の値を設定した .env ファイルをフォルダー内に作成します。サンプルファイルはこちらから入手できます。
• 上記のフォルダーから uv run oracledb_mcp_server を実行して、oracledb_mcp_server サーバーをテストします。

Claud Desktop

• 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）

インターセプター

npx @modelcontextprotocol/inspector uv --directory "D:\\MyDev\\mcp\\oracledb_mcp_server" run -m oracledb_mcp_server

コントリビューション

コントリビューションを歓迎します。
お気軽にプルリクエストを送信してください。

ライセンス

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

デモ

GitHub スター数