oracle-sqlplus-mcp

sqlplusを接続バックエンドとして使用するOracle Database用MCP（Model Context Protocol）サーバーです。Oracle Instant ClientのNode.jsバインディングは不要で、sqlplusバイナリが動作すれば利用可能です。

前提条件

• sqlplusがインストールされており、PATHに通っていること（Oracle Instant ClientまたはフルOracleクライアントに付属）

• Node.js 18以上

Related MCP server: oracle-db-mcp

インストール

npm install -g oracle-sqlplus-mcp
# or run directly with npx (no install needed):
npx oracle-sqlplus-mcp

接続文字列の形式

username/password@host:port/servicename

例:

scott/tiger@localhost:1521/ORCL
myuser/mypass@192.168.1.10:1521/XEPDB1
admin/secret@db.example.com:1521/PROD

Claude Desktopの設定

claude_desktop_config.jsonに以下を追加します:

{
  "mcpServers": {
    "oracle": {
      "command": "npx",
      "args": ["-y", "oracle-sqlplus-mcp"],
      "env": {
        "ORACLE_CONNECTION": "username/password@host:port/servicename"
      }
    }
  }
}

オプションの環境変数

カスタムsqlplusパスの例

{
  "mcpServers": {
    "oracle": {
      "command": "npx",
      "args": ["-y", "oracle-sqlplus-mcp"],
      "env": {
        "ORACLE_CONNECTION": "scott/tiger@192.168.1.10:1521/ORCL",
        "SQLPLUS_PATH": "C:\\oracle\\instantclient_21_9\\sqlplus.exe",
        "QUERY_TIMEOUT_MS": "60000"
      }
    }
  }
}

利用可能なツール

プロンプトの例

• "Oracleへの接続をテストして"

• "データベース内の全スキーマをリストアップして"

• "SCOTTスキーマ内のテーブルを見せて"

• "EMPLOYEESテーブルの構造を教えて"

• "HR.EMPLOYEESからサンプルを5行取得して"

• "次のクエリを実行して: SELECT * FROM departments WHERE department_id < 50"

• "HRスキーマ内の全ストアドプロシージャをリストアップして"

トラブルシューティング

sqlplus: command not found

SQLPLUS_PATHにsqlplusバイナリのフルパスを設定してください。

ORA-12541: TNS:no listener

ホスト、ポート、およびOracleリスナーが起動しているか確認してください。

ORA-01017: invalid username/password

認証情報を確認してください。接続文字列の形式: user/pass@host:port/service。

SP2-0306: Invalid option

sqlplusのバージョンが-Sサイレントモードをサポートしているか確認してください（最近のバージョンはすべてサポートしています）。