OracleDB MCP サーバー

概要

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

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

Related MCP server: MCP Oracle Server

インストール

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

  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)

インターセプター

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

貢献

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

ライセンス

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

デモ

Githubスター