access_mcp_resource

access_mcp_resource ツールは、接続済みのモデルコンテキストプロトコル（Model Context Protocol、MCP）サーバーが公開するリソースからデータを取得するために使用されます。VJSP がファイル、API レスポンス、ドキュメント、システム情報にアクセスできるようにし、タスク実行に追加コンテキストを提供します。

パラメータ説明

このツールは次のパラメータを受け取ります：

server_name（必須）：ターゲットリソースを提供する MCP サーバー名
uri（必須）：アクセスする特定のリソースを識別する統一リソース識別子

機能定位

このツールは MCP サーバーとの接続を確立し、公開されたリソースからデータを取得します。操作実行タイプの use_MCP_tool ツールとは異なり、このツールはタスクにコンテキストサポートを提供する情報クラスのデータを取得するために専用です。

適用シナリオ

VJSP が外部システムから追加コンテキストを取得する必要がある場合
VJSP が専門 MCP サーバーからドメイン固有のデータを取得する必要がある場合
VJSP が MCP サーバーによってホストされる参照ドキュメントを検索する必要がある場合
VJSP が MCP を介して外部 API からリアルタイムデータを統合する必要がある場合

コア機能

MCP リソースからテキストと画像の両方のデータを取得するサポート
リソースアクセス操作を実行する前にユーザーの承認が必要
URI アドレス指定メカニズムに基づくリソースの正確な位置決め
モデルコンテキストプロトコル開発キット（MCP SDK）との深度統合
コンテンツタイプに応じたリソースコンテンツの適応的な表示
ネットワーク操作の信頼性を確保するためのタイムアウト設定のサポート
サーバーのマルチ接続状態処理（接続済み、接続中、切断済み）との互換性
接続済みサーバーから利用可能なリソースを発見するサポート
メタデータ付きの構造化応答データを処理できる
画像コンテンツに専用のレンダリング処理ロジックを提供

制限事項

外部 MCP サーバーのオンライン状態と接続の有効性に依存
接続済みサーバーが提供するリソースのみにアクセスできる
無効化されたサーバー内のリソースにアクセスできない
ネットワーク障害はツールの信頼性と実行パフォーマンスに影響を与える
リソースアクセスは設定されたタイムアウト時間に制限される
URI 形式は特定の MCP サーバーの実装ロジックによって定義される
リソースのオフラインアクセスとキャッシュ読み取り機能はサポートされていない

実行フロー

access_mcp_resource ツールを呼び出すと、次のフローが実行されます：

接続有効性検証
- MCP ハブノードが展開され、初期化されているかどうかを検証
- 指定されたサーバーが接続リストに存在するかどうかを確認
- サーバーが無効化されているかどうかをチェック（無効化されている場合は直接エラーを返す）
ユーザー操作承認
- リソースアクセスリクエストをユーザーにプッシュし、承認確認を待機
- アクセスするサーバー名とリソース URI を表示し、ユーザーに確認させる
- ユーザーの承認を得た後にのみ、後続の操作を続行
リソースリクエストの開始
- MCP SDK に基づいてターゲットサーバーと通信
- MCP ハブノードを介してターゲットサーバーに resources/read リソース読み取りリクエストを送信
- サーバーの無応答によるプロセスのブロックを回避するために、設定されたタイムアウトメカニズムを有効にする
レスポンス結果の処理
- メタデータとコンテンツ配列を含む構造化されたレスポンスデータを受信
- テキストコンテンツを解析処理し、ユーザー表示シナリオに適応させる
- 画像データに専用の処理ロジックを実行し、表示効果を確保する
- 処理されたリソースデータを VJSP に返し、現在のタスク実行をサポートする

リソースタイプ

MCP サーバーは 2 種類のコアリソースを提供できます：

標準リソース
- 固定 URI を持つ静的リソース
- 事前定義された名前、説明、MIME タイプ（Multipurpose Internet Mail Extensions）を含む
- パラメータなしで直接アクセスできる
- 通常、静的データやリアルタイム更新される基本情報を保持するために使用される
リソーステンプレート
- URI にプレースホルダーを含むパラメータ化されたリソース
- 入力パラメータに応じてリソースコンテンツを動的に生成するサポート
- データクエリまたはフィルタービューを実装するために使用できる
- 柔軟性が高いが、追加の URI フォーマットルールに従う必要がある

実際のアプリケーションシナリオ

API 開発を支援する場合、VJSP は MCP リソースからインターフェース仕様を取得し、実装ロジックの正確性を確保します
データ可視化を支援する場合、VJSP は接続済みの MCP サーバーから最新のデータサンプルを取得します
専門分野のタスクを処理する場合、VJSP は技術ドキュメントを検索し、操作に正確なガイダンスを提供します
業界固有のコードを生成する場合、VJSP はドキュメントリソース内のコンプライアンス要件を参照し、コードが業界規格に準拠していることを確保します

使用例

リアルタイム天気データにアクセス

<access_mcp_resource>
<server_name>weather-server</server_name>
<uri>weather://san-francisco/current</uri>
</access_mcp_resource>

API ドキュメントを検索

<access_mcp_resource>
<server_name>api-docs</server_name>
<uri>docs://payment-service/endpoints</uri>
</access_mcp_resource>

ドメイン固有の知識ベースにアクセス

<access_mcp_resource>
<server_name>knowledge-base</server_name>
<uri>kb://medical/terminology/common</uri>
</access_mcp_resource>

システム構成情報を取得

<access_mcp_resource>
<server_name>infra-monitor</server_name>
<uri>config://production/database</uri>
</access_mcp_resource>

access_mcp_resource ​

パラメータ説明 ​

機能定位 ​

適用シナリオ ​

コア機能 ​

制限事項 ​

実行フロー ​

リソースタイプ ​

実際のアプリケーションシナリオ ​

使用例 ​