日日是Oracle APEX: MCP AppsのサンプルアプリBudget Allocator Serverをデータベースで実行する

2026年4月16日木曜日

MCP AppsのサンプルアプリBudget Allocator Serverをデータベースで実行する

GitHubのリポジトリmodelcontextprotocol/ext-appsに含まれているBudget Allocator Serverをデータベースでホストしてみます。今回はClaude Desktopから呼び出せるように、Autonomous AI Databaseを使用します。Autonomous AI Databaseでの準備作業は、以下の記事で紹介しています。

MCPを話すOracle Databaseを作成する - Autonomous AI Database編

Claude Desktopでは以下のように動作します。

Budget Allocator Serverのサーバーはserver.tsで実装されています。以下の方針で、データベースに実装し直しています。データベースで実行するスクリプトはClaude Sonnetに生成してもらいました。

Zodによるスキーマ定義を切り出し、Oracle Database向けの表定義を生成させました。（スクリプト：bas_create_tables.sql）
サンプルデータを生成するファンクションseededRandomとgenerateHistoryを取り出し、PL/SQLで書き直してもらいました。（スクリプト：bas_generate_history.sql）
表bas_budget_categories、bas_budget_analyticsへの初期データの投入を行なうINSERT文を生成させました。（スクリプト：bas_prepare_budget_categories.sql、bas_prepare_budget_analytics.sql）
表bas_budget_config、bas_budget_preset_budgetsへの初期データの投入については、自分でINSERT文を書きました。（スクリプト：bas_prepare_budget_config.sql）
ツールが返す構造化出力を生成するファンクションbas_get_budget_data_responseを生成させました。（スクリプト：bas_get_budget_data_response.sql）

本記事の目的はMCPアプリをデータベースでホストすることなので、PL/SQLで実装されたサーバーがTypeScriptの機能と完全に互換かどうかという点は確認していません。MCPアプリが動作すれば良しとしています。

CREATE TABLE文を生成する部分、INSERT文を生成するデータ準備部分、それとツール本体となるプロシージャを生成する部分に、作業を分けてコード生成させましたが、server.tsを丸投げしても良かったかもしれません。

これらを一括で実行するスクリプトbas_install.sqlを作成しています。リポジトリmcp-appにmcp-app/examples/budget-allocator-server/bas_install.sqlとして含まれているので、リモートMCPサーバーを実装しているスキーマに接続して実行します。

Autonomous AI Database向けの構築手順にそって作成した環境であれば、Autonomous AI Lakehouseの19cのデータベースがSALESADBとして作成され、APEXワークスペースのスキーマとしてWKSP_APEXDEVが作成されています。この環境を前提とすると、以下のコマンドでBuget Allocator Serverのサーバーを実装できます。

sql -cloudconfig Wallet_SALESADB.zip wksp_apexdev@salesadb_low
@mcp-app/examples/budget-allocator-server/bas_install.sql

データベースにサーバーが実装されたことを確認するために、スクリプト実行の最後にツール呼び出しのレスポンスを出力しています。

mcp-salesadb % sql -cloudconfig Wallet_SALESADB.zip wksp_apexdev@salesadb_low

SQLcl: 木 4月 16 12:39:12 2026のリリース25.4 Production

パスワード (**********?) ****************

接続先:

Oracle Database 19c Enterprise Edition Release 19.0.0.0.0 - Production

Version 19.31.0.1.0

SQL> @mcp-app/examples/budget-allocator-server/bas_install.sql

Table BAS_BUDGET_CATEGORIESは作成されました。

Table BAS_BUDGET_CONFIGは作成されました。

Table BAS_BUDGET_CONFIG_PRESET_BUDGETSは作成されました。

Table BAS_HISTORICAL_MONTHSは作成されました。

Table BAS_HISTORICAL_MONTH_ALLOCATIONSは作成されました。

Table BAS_BUDGET_ANALYTICSは作成されました。

Table BAS_BUDGET_ANALYTICS_STAGESは作成されました。

Table BAS_STAGE_BENCHMARKSは作成されました。

Table BAS_STAGE_BENCHMARK_PERCENTILESは作成されました。

Commentは作成されました。

Procedure BAS_GENERATE_HISTORYがコンパイルされました

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

1行挿入しました。

コミットが完了しました。

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

コミットが完了しました。

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

Oracle Database 19c Enterprise Edition Release 19.0.0.0.0 - Production

Version 19.31.0.1.0から切断されました

mcp-salesadb %

サーバーの実装を削除するスクリプトbas_drop_all.sqlも用意しています。

以上でサーバー側の実装はできました。

APEXアプリケーションをインストールして、Budget AllocatorをMCPアプリとして登録します。

Autonomous AI DatabaseのAPEXに接続し、アプリケーション・ビルダーからインポートを実行します。

リポジトリmcp-appに含まれるMCP App Helperアプリmcp-app/app/mcp-app-helper.sqlをインポートします。

次へ進みます。

アプリケーションのインストールを実行します。

アプリケーションがインストールされます。

アプリケーションの編集を開き、アプリケーションの名前と別名を更新します。

アプリケーションの名前をext-apps、別名をext-appsとします。

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

最初にHandlersを開き、リモートMCPサーバーのエンドポイントとなるORDS RESTサービスをインストールします。

作成をクリックします。

ORDSのRESTモジュール名はAPEXアプリの別名と同じにします。これはリモートMCPサーバーの実装上、必須になっています。

リモートMCPサーバーのエンドポイントURLは以下になります。

https://リバースプロキシのホスト/ords/ORDS別名/ext-apps/mcp

デフォルトの設定のまま、作成をクリックします。

ORDSのRESTモジュールとしてext-apps、テンプレートとしてmcp、そのテンプレートにPOSTハンドラとDELETEハンドラが作成されます。

Resourcesを開き、UIリソースとしてBudget Allocatorを作成します。

作成をクリックします。

以下の値でUIリソースBudget Allocatorを作成します。

Uri: ui://budget-allocator/mcp-app.html

Name: Budget Allocator

Description: Interactive Budget Allocator UI

作成したUIリソースBudget Allocatorに実際のアプリを登録します。Bundleを開きます。

Resource IDにBudget Allocatorを選択し、bundle html fileにリポジトリext-appsに含まれるext-apps/examples/budget-allocator-server/dist/mcp-app.htmlを選択します。

Updateをクリックし、MCPアプリをデータベースにアップロードします。

Toolsを開き、ツールとしてget-budget-dataを作成します。

Code: get-budget-data
Description: Returns budget configuration with 24 months of historical allocations and industry benchmarks by company stage

Input Schema: {"$schema":"http://json-schema.org/draft-07/schema#","type":"object"}
Function Call: return bas_get_budget_data_response();
Tags: ext-apps

Resource Id: Budget Allocator

Output Schemaには、こちらの内容output_schema.jsonを記述します。

以上で作成をクリックします。