日日是Oracle APEX: MCP AppをOracle DatabaseとOracle REST Data Servicesで実装する

以下の２つの記事で実装したリモートMCPサーバーのフレームワークを使って、MCP Appを実装します。

作業環境は、UC Local APEX Devで作成した手元のOracle Database FreeおよびORDSのコンテナを使用します。利用方法については、こちらの記事「United CodesのUC Local APEX Devを使ってOracle APEXのローカル開発環境を作成する」で紹介しています。

ローカル環境へは以下のURLでアクセスします。

http://localhost:8181/ords/apex

以下のコマンドを実行してAPEXのワークスペースを作成します。以下の例ではワークスペースをapexdevとして作成しています。

local-26ai.sh create-user apexdev

APEXのワークスペースとしてapexdev、管理者ユーザーapexdev、それとデフォルト・パーシング・スキーマとなるスキーマAPEXDEVが作成されます。Autonomous AI Databaseでワークスペースを作成した場合は、スキーマWKSP_APEXDEVが作成されます。UC Local APEX Devではスキーマ名に接頭辞WKSP_は付きません。

管理者ユーザーのデフォルトのパスワードはWelcome_1です。

mcp-app % local-26ai.sh create-user apexdev

loaded .env file

SQLcl: 金 3月 06 16:36:42 2026のリリース25.4 Production

接続先:

Oracle AI Database 26ai Free Release 23.26.1.0.0 - Develop, Learn, and Run for Free

Version 23.26.1.0.0

USER

_______

SYS

[中略]

Oracle AI Database 26ai Free Release 23.26.1.0.0 - Develop, Learn, and Run for Free

Version 23.26.1.0.0から切断されました

>>>>

saved sqlcl connection

connect with 'sql -name local-26ai-apexdev'

mcp-app %

作成されたスキーマにUC_AIをLogger付きで導入します。Loggerを個別にスキーマにインストールするためには、CREATE ANY CONTEXT権限が必要です。

FREEPDB1にSYSで接続し、スキーマAPEXDEVに権限を与えます。

sql -name local-26ai-sys

grant create any context to apexdev;

exit;

mcp-app % sql -name local-26ai-sys

SQLcl: 金 3月 06 16:41:57 2026のリリース25.4 Production

接続先:

Oracle AI Database 26ai Free Release 23.26.1.0.0 - Develop, Learn, and Run for Free

Version 23.26.1.0.0

SQL> grant create any context to apexdev;

Grantが正常に実行されました。

SQL> exit

Oracle AI Database 26ai Free Release 23.26.1.0.0 - Develop, Learn, and Run for Free

Version 23.26.1.0.0から切断されました

mcp-app %

UC_AIのリポジトリをクローンします。

git clone https://github.com/United-Codes/uc_ai.git

mcp-app % git clone https://github.com/United-Codes/uc_ai.git

Cloning into 'uc_ai'...

remote: Enumerating objects: 2703, done.

remote: Counting objects: 100% (421/421), done.

remote: Compressing objects: 100% (288/288), done.

remote: Total 2703 (delta 177), reused 212 (delta 120), pack-reused 2282 (from 1)

Receiving objects: 100% (2703/2703), 6.26 MiB | 8.64 MiB/s, done.

Resolving deltas: 100% (1770/1770), done.

mcp-app %

クローンしたリポジトリに移動し、install_with_logger.sqlを実行します。

cd uc_ai
sql -name local-26ai-apexdev @install_with_logger

exit

mcp-app % cd uc_ai

uc_ai % sql -name local-26ai-apexdev @install_with_logger

SQLcl: 金 3月 06 16:48:33 2026のリリース25.4 Production

接続先:

Oracle AI Database 26ai Free Release 23.26.1.0.0 - Develop, Learn, and Run for Free

Version 23.26.1.0.0

Installing UC AI with logger

_____________________________________________________________________________

User has all required privileges, installation will continue.

_____________________________________________________________________________

[中略]

Package Body UC_AIがコンパイルされました

Running post-installation scripts...

Logger package detected. Setting USE_LOGGER flag to TRUE.

Successfully compiled uc_ai_logger package with USE_LOGGER flag.

PL/SQLプロシージャが正常に完了しました。

===================================================

UC AI installation complete!

Refer to the documentation for usage instructions: https://www.united-codes.com/products/uc-ai/docs/

===================================================

Installation Complete!

SQL> exit

Oracle AI Database 26ai Free Release 23.26.1.0.0 - Develop, Learn, and Run for Free

Version 23.26.1.0.0から切断されました

uc_ai %

APEXのワークスペースにサインインし、MCPサーバーがセッション管理に使用するAPEXアプリケーションを作成します。

アプリケーション・ビルダーを開きます。

アプリケーションの作成を開始します。

APEXアプリケーションは存在するだけでよいです。IDの数値はスクリプト実行時に使用するので、覚えておきます。

アプリケーションの作成を実行します。

アプリケーションが作成されます。APEXでの作業は以上で完了です。

リモートMCPサーバーを実装するスクリプトsetup-sample-mcp-server.sqlをダウンロードします。スクリプトの先頭で定義されているAPEX_APP_IDに先ほど作成したAPEXアプリケーションのIDを指定します。ORDS_PATH_PREFIXには、APEXのワークスペースの名前を英子文字で指定します。

以上の変更を行い、スクリプトを実行します。

sql -name local-26ai-apexdev @ setup-sample-mcp-server.sql

mcp-app % sql -name local-26ai-apexdev @ setup-sample-mcp-server.sql

SQLcl: 金 3月 06 17:03:03 2026のリリース25.4 Production

接続先:

Oracle AI Database 26ai Free Release 23.26.1.0.0 - Develop, Learn, and Run for Free

Version 23.26.1.0.0

PL/SQLプロシージャが正常に完了しました。

Function GET_SCHEMAがコンパイルされました

Function RUN_SQLがコンパイルされました

Function GET_CURRENT_USERがコンパイルされました

PL/SQLプロシージャが正常に完了しました。

Package MCP_HTTP_SERVER_PKGがコンパイルされました

Package Body MCP_HTTP_SERVER_PKGがコンパイルされました

Package MCP_SAMPLEがコンパイルされました

Package Body MCP_SAMPLEがコンパイルされました

PL/SQLプロシージャが正常に完了しました。

SQL> exit

Oracle AI Database 26ai Free Release 23.26.1.0.0 - Develop, Learn, and Run for Free

Version 23.26.1.0.0から切断されました

mcp-app %

上記のスクリプトでは、MCP Appとなるツールget_current_userにHTML/JavaScript/CSSのリソースがほとんど記述されていません。

PL/SQLのコードを一切変更せずに、ユーザー・インターフェースだけをClaudeに書いてもらうために、リソースの部分だけを別ファイルにしています。Claudeが生成したコードは以下です。１行だけcallServerToolの引数を古い仕様で認識していてコードの修正が明後日の方向に進んだので、手動で修正しました。

sql -name local-26ai-apexdev @ update-ui-get-current-user.sql

mcp-app % sql -name local-26ai-apexdev @ update-ui-get-current-user.sql

SQLcl: 金 3月 06 17:12:15 2026のリリース25.4 Production

接続先:

Oracle AI Database 26ai Free Release 23.26.1.0.0 - Develop, Learn, and Run for Free

Version 23.26.1.0.0

PL/SQLプロシージャが正常に完了しました。

Oracle AI Database 26ai Free Release 23.26.1.0.0 - Develop, Learn, and Run for Free

Version 23.26.1.0.0から切断されました

mcp-app %

今回はOpenID Connectによるユーザー認証は不要なので、ORDSのRESTサービスの保護を解除します。

sql -name local-26ai-apexdev @ unprotect-sampleserver.sql

mcp-app % sql -name local-26ai-apexdev @ unprotect-sampleserver.sql

SQLcl: 金 3月 06 17:17:33 2026のリリース25.4 Production

接続先:

Oracle AI Database 26ai Free Release 23.26.1.0.0 - Develop, Learn, and Run for Free

Version 23.26.1.0.0

PL/SQLプロシージャが正常に完了しました。

Oracle AI Database 26ai Free Release 23.26.1.0.0 - Develop, Learn, and Run for Free

Version 23.26.1.0.0から切断されました

mcp-app %

以上で実装作業は完了です。

MCP Inspectorを実行します。

npx @modelcontextprotocol/inspector

Transport TypeにStreamable HTTP、URLに以下を指定します。

http://localhost:8181/ords/apexdev/sampleserver/mcp

Connect を実行します。

Appsタブを開きます。

MCP Appsとしてリソースが定義されているツールget_current_userがリストされます。

get_current_userをクリックすると、ユーザー・インターフェースが表示されます。

ユーザー・インターフェースにあるボタンGet Current Userをクリックします。

ツールget_current_userが呼び出され、ユーザー名として（ユーザー認証を実装していないため）スキーマ名APEXDEVが表示されます。

Autonomous AI Databaseを対象にして上記のスクリプトを実行して、OpenAI ChatGPTにアプリとして登録すると、以下の様にChatGPTにアプリが埋め込まれて操作することができました。

Claudeでカスタムコネクタとして登録しても、アプリを埋め込めなかったです。

まだ、クライアントによる差異はあるようです。

今回の記事は以上になります。

完

2026年3月6日金曜日

MCP AppをOracle DatabaseとOracle REST Data Servicesで実装する