CAST Imaging MCP Server

CAST Imaging MCP サーバー

概要

CAST Imaging MCP サーバーは、Model Context Protocol（MCP）を通じて包括的なソフトウェアインテリジェンスを公開し、AI エージェントと実際のソフトウェアアーキテクチャをつなぎます。AI エージェントにプロンプトを送ることで、アプリケーション、トランザクション、依存関係、品質パターン、アーキテクチャ構造についての知見を得られます。

このサービスは、ポートフォリオレベルのインベントリから詳細なオブジェクト間の関係まで、アプリケーションを理解するための情報を AI エージェントに提供します。データベーススキーマの調査、トランザクションフローの分析、品質上の問題の調査など、MCP サーバーは正確なページ分割データを提供し、情報に基づくアーキテクチャ上の意思決定を支援します。

ユースケース

• ポートフォリオレベルの調査：CAST Imaging で利用可能なアプリケーションを一覧表示し、それらの詳細情報を提供します。
• アプリケーションアーキテクチャの分析：さまざまなレベルのアーキテクチャグラフを調査し、システム構造を可視化します。
• トランザクションとデータフローのマッピング：トランザクションを分析し、データエンティティの相互作用ネットワークを追跡し、複雑なオブジェクトやシーケンスを調査します。
• 品質とセキュリティに関する知見：アプリケーション内の脆弱性、クラウド対応を妨げる要因、構造上の欠陥を特定します。
• データベーススキーマの調査：アプリケーション間のデータベーステーブル、列、関係、制約を確認します。
• オブジェクトレベルの調査：オブジェクトとそのプロパティを検索し、呼び出し元／呼び出し先の関係を分析します。

---

目次

• 前提条件
• クイックスタート
• インストール
• 設定リファレンス
• 実行（HTTP）
• Windows へのインストール
• VS Code + GitHub Copilot の設定
• 検証とテストクエリ
• ツールセットとツール
• トラブルシューティング
• セキュリティに関する注意事項
• パッケージの内容
• サポート

---

前提条件

必須

• Linux システムに Docker がインストールされ、実行されていること。
• このホストから CAST Imaging‑APIs サービスにアクセスできること
• MCP 対応クライアント（例：VS Code の GitHub Copilot、Claude Desktop）
• CAST Imaging API キー（Imaging のユーザープロファイルから生成）

ダウンロード

• CAST Imaging MCP サーバーのインストーラーをダウンロードします

MCP サーバーは Linux システムで実行してください。CAST Imaging‑APIs は同じ Linux マシンでも、別の Linux マシンでも実行できます。

---

クイックスタート

1. Imaging‑APIs が稼働していることを確認します：

   curl -H "x-api-key: <your-imaging-api-key>"         http://{CONTROL_PANEL_HOST}:8090/imaging/apis/rest/ready
   # expected: true
   

2. インストーラーの zip を展開します。
3. config/app.config と .env を設定します。
4. ./run.sh --install でサーバーを起動します。
5. サーバーの URL を指定してクライアントを設定します（VS Code Copilot または Claude）。
6. クエリをテストします（以下の例を参照）。

---

CAST Imaging MCP サーバーのインストール

1) インストーラーを展開する

com.castsoftware.imaging.mcpserver.docker.1.0.2-funcrel/
├─ config/
│  └─ app.config
├─ .env                      # hidden; use `ls -a`
├─ docker-compose.yml
├─ run.sh
├─ README.md
└─ copilot-instructions.md

2) CAST Imaging‑APIs を確認する

Control Panel／レジストリにアクセスでき、Imaging‑APIs の準備ができていることを確認します（クイックスタートの手順 #1 を参照）。

3) サーバーを設定する

config/app.config を編集します：

HOST_CONTROL_PANEL="your-control-panel-host"   # REQUIRED: Control Panel service registry host/IP
PORT_CONTROL_PANEL=8098                        # Default Control Panel registry port
IMAGING_PAGE_SIZE=1000                         # Internal fetch batch size
IMAGING_DISPLAY_PAGE_SIZE=20                   # Page size in responses
IMAGING_CODE=False                             # Source code access via MCP (security sensitive)
DEBUG_MODE=false                               # Debug mode to see the activity in logs
IMAGING_DOMAIN="default"                       # Imaging domain/tenant
CONTROL_PANEL_SSL_ENABLED=false                # Set true only if Control Panel config/eureka is on HTTPS
MCP_TOOL_SURFACE_PROFILE="full"                # MCP tool exposure profile: "intents" or "full"
MCP_INTENTS_HIDDEN_FUNCTIONS=""                # Comma-separated structural functions hidden from intents mode
SERVICE_HOST="your-service-host"               # REQUIRED: The IP/hostname of the machine on which the MCP Server is running
SSL_CA_BUNDLE=""                               # Optional PEM bundle for private/self-signed CAs

公開ポートを .env（隠しファイル）で設定します：

MCP_SERVER_PORT=8282

ヒント： Linux では、.env のようにドットで始まるファイルは隠しファイルです。ls -a を使うと表示できます。

4) 起動する

chmod +x run.sh
./run.sh --install

これにより、Docker Compose スタックと MCP サーバーが起動します。

SSL_CA_BUNDLE を使用する場合は、PEM ファイルを docker-compose.yml と同じ場所にある certificates/ フォルダーに配置します。Compose ファイルはこのフォルダーをコンテナ内の /app/certificates にマウントします。

---

設定リファレンス

HOST_CONTROL_PANEL（必須）

デフォルト： なし（ユーザーが値を指定する必要があります）
説明： Control Panel Service を実行しているマシンの IP アドレスまたはホスト名です。

これは、Imaging が内部サービスを登録して検出するために使用するサービスレジストリです。Imaging をインストールすると自動的にデプロイされます。Imaging Control Panel サービスを実行している Linux マシンの IP アドレスを入力してください。

PORT_CONTROL_PANEL

デフォルト： 8098
説明： Control Panel のレジストリポートです。

IMAGING_PAGE_SIZE

デフォルト： 1000
説明： MCP サーバーがリクエストごとに取得するレコード数（内部バッチ処理）を設定します。スループットに合わせて調整してください。

IMAGING_DISPLAY_PAGE_SIZE

デフォルト： 20
説明： ユーザー向けの応答で、1ページあたりに表示するレコード数を設定します。UX に合わせて調整してください。

IMAGING_CODE

デフォルト： False
説明： エージェントが MCP サーバー経由でソースコードにアクセスできるかどうかを制御します。

通常、エージェントは公開リポジトリで作業するため、デフォルト値は false です。有効にすると、MCP にアクセスできるすべてのユーザーにソースコードが公開される可能性があるため、セキュリティリスクとなるおそれがあります。特に、リポジトリに直接アクセスできない Claude デスクトップなどのクライアントでは注意が必要です。

DEBUG_MODE

デフォルト： false
説明： デバッグモードを有効にすると、ログにアクティビティが表示されます。true に設定すると、各ユーザープロンプトで選択されたツール、呼び出された API、結果が表示されます。false に設定すると、選択されたツールと対応する API 呼び出しのみが表示されます。

IMAGING_DOMAIN

デフォルト： default
説明： マルチテナント環境でデータを取得する際に使用する Imaging のドメイン／テナントです。

CONTROL_PANEL_SSL_ENABLED

デフォルト： false
説明： Control Panel の設定／Eureka エンドポイントが HTTPS で動作している場合は、true に設定します。

MCP_TOOL_SURFACE_PROFILE

デフォルト： full 説明： MCP ツールの公開プロファイルを選択します。ツールセット全体を公開するには full、メタツールのサーフェスを公開するには intents を使用します。

MCP_INTENTS_HIDDEN_FUNCTIONS

デフォルト： 空 説明： MCP_TOOL_SURFACE_PROFILE が intents に設定されている場合に非表示にする構造関数を、カンマ区切りで指定します。

SERVICE_HOST（必須）

デフォルト： なし（ユーザーが値を指定する必要があります）
説明： MCP Server が実行されているマシンの IP アドレス／ホスト名です。

SSL_CA_BUNDLE

デフォルト： 空
説明： プライベートまたは自己署名証明書チェーン用の CA バンドル（PEM）の任意のパスです。Docker インストーラーを使用する場合は、PEM ファイルを ./certificates/ に配置し、/app/certificates/<file>.pem として指定します。

---

実行（HTTP）

次のコマンドでサーバーを起動します：

chmod +x run.sh
./run.sh --install

---

Windows へのインストール

このセクションでは、Windows システムに CAST Imaging MCP Server をインストールして設定する手順を詳しく説明します。

Windows の前提条件

• Windows システム
• CAST Imaging‑APIs サービスが稼働し、アクセス可能であること
• MCP 対応クライアント（例：VS Code の GitHub Copilot、Claude Desktop）
• CAST Imaging API キー（Imaging のユーザープロファイルから生成）

1) ダウンロードと展開

1. Windows 用のインストーラーパッケージをダウンロードします。
2. ZIP ファイルを任意の場所に展開します。
3. 展開したディレクトリに移動します。

パッケージの内容：

com.castsoftware.imaging.mcpserver.__MCP_VERSION__*/
├─ mcpserver/
├─ tools/
├─ configuration.conf
├─ mcp-server-installer.bat
└─ README.md

2) CAST Imaging‑APIs の確認

Control Panel／レジストリにアクセスでき、Imaging‑APIs が使用可能であることを確認します：

curl -H "x-api-key: <your-imaging-api-key>" 
     http://{HOSTNAME_CONTROL_PANEL}:8090/rest/ready
# expected: true

3) サーバーの設定

環境設定に合わせて configuration.conf を編集します：

HOSTNAME_CONTROL_PANEL="your-control-panel-host"      # Required: IP or hostname of Control Panel server
SERVICE_HOST="your-service-host"                      # Required: IP/hostname of the MCP Server machine
PORT_CONTROL_PANEL=8098                               # Default Control Panel registry port  
MCP_SERVER_PORT=8282                                  # Default MCP server port
INSTALL_DIR=C:\Program Files\Cast\Imaging-MCP-Server  # Default installation location
CONFIG_DIR=C:\ProgramData\CAST\Imaging-MCP-Server     # Default config files location
IMAGING_PAGE_SIZE=1000                                # Records per internal request
IMAGING_DISPLAY_PAGE_SIZE=20                          # Records per response page
IMAGING_CODE=False                                    # Enable source code access (security consideration)
DEBUG_MODE=false                                      # Debug mode to see the activity in logs
IMAGING_DOMAIN=default                                # Imaging domain/tenant
CONTROL_PANEL_SSL_ENABLED=false                       # Set true only if Control Panel config/eureka is on HTTPS
MCP_TOOL_SURFACE_PROFILE=full                         # MCP tool exposure profile: full or intents
MCP_INTENTS_HIDDEN_FUNCTIONS=                         # Comma-separated structural functions hidden from intents mode
SSL_CA_BUNDLE=                                        # Optional PEM bundle for private/self-signed CAs

4) Windows サービスとしてインストール

バッチスクリプトを使用してインストールを実行します：

mcp-server-installer.bat --install configuration.conf

これにより、MCP サーバーが Windows サービスとしてインストールされます。インストールが正常に完了すると、サービス一覧に 「CAST Imaging MCP Server」 という名前の Windows サービスが表示されます。

5) インストールの確認

サービスが実行中であることを確認します：

• サービス（services.msc）を開きます。
• **「CAST Imaging MCP Server」**を探します。
• 状態が **「実行中」**であることを確認します。

Windows 固有の操作

MCP サーバーの更新

既存のインストールを更新するには：

mcp-server-installer.bat --update

更新時に設定を変更する必要はありません。

MCP サーバーのアンインストール

MCP サーバーを完全に削除するには：

mcp-server-installer.bat --uninstall

Windows サービスが削除され、MCP 関連のすべてのファイルがクリーンアップされます。

ヘルプの表示

使用可能なコマンドを確認するには：

mcp-server-installer.bat --help

使用可能なコマンド：

mcp-server-installer.bat --install configuration.conf   : Install CAST Imaging MCP server
mcp-server-installer.bat --update                       : Update CAST Imaging MCP server
mcp-server-installer.bat --uninstall                    : Uninstall CAST Imaging MCP server
mcp-server-installer.bat --help                         : Display help message

Windows のトラブルシューティング

問題	考えられる原因	解決方法
サービスが起動しない	設定エラー	%CONFIG_DIR%/setup-config/app.config を確認してください
接続が拒否される	サービスが実行されていない	「CAST Imaging MCP Server」サービスを再起動してください
インストールに失敗する	権限が不十分	インストーラーを管理者として実行してください

---

VS Code + GitHub Copilot のセットアップ

このセクションでは、CAST Imaging MCP Server を Github Copilot に接続するための詳しい手順を説明します。

1) VS Code に GitHub Copilot をインストールする

• 拡張機能ビューを開きます（Ctrl+Shift+X または Cmd+Shift+X）。
• 「GitHub Copilot」を検索し、「インストール」をクリックします。
• 表示されたら GitHub にサインインします。

2) CAST Imaging API キーを生成する

• CAST Imaging にログインします。
• プロフィールのセクションに移動します。
• 新しい API キーを生成します（次の手順で必要になるため、このキーをコピーして安全に保存してください）。

3) MCP 設定（.vscode/mcp.json）を作成する

• VS Code で任意のフォルダーを開き、ルートに .vscode フォルダーを作成します。その中に mcp.json ファイルを作成します。

{
  "inputs": [
    {
      "id": "imaging-key",
      "type": "promptString",
      "description": "CAST Imaging API Key"
    },
    {
      "id": "imaging-tenant",
      "type": "promptString",
      "description": "Imaging tenant"
    }
  ],
  "servers": {
    "imaging": {
      "type": "http",
      "url": "http://<your-mcp-server-host:port>/mcp/",
      "headers": {
        "x-api-key": "${input:imaging-key}",
        "x-user-tenant": "${input:imaging-tenant}"
      }
    }
  }
}

4) （代替手順）手動で登録する

VS Code がサーバーを自動検出しない場合：

1. Copilot Chat → 歯車アイコン → チャットで使用できるツールを選択 を開きます。
2. + ツールを追加… → + MCP サーバーを追加… → HTTP を選択します。
3. http(s)://<your-mcp-server-host:port>/mcp/ を入力し、確定します。
4. VS Code が .vscode/copilot/mcp.json を書き込みます → ヘッダーブロックを追加します。

"my-mcp-server-xxxx": {
  "url": "http://<your-mcp-server-host:port>/mcp/",
  "headers": {
    "x-api-key": "${input:imaging-key}",
    "x-user-tenant": "${input:imaging-tenant}"
  }
}

5) Copilot 用のプロジェクト指示

インストーラーから copilot-instructions.md をコピーし、.github という名前のフォルダーを作成して、その中に copilot-instructions.md ファイルを貼り付け、VS Code に配置します。これにより、エージェントがより良い応答を提供できるようになります。

---

検証とテストクエリ

接続チェック

# MCP container running
docker ps | grep mcp-server

# Imaging‑APIs health
curl -H "x-api-key: <your-key>"      http://{CONTROL_PANEL_HOST}:8090/imaging/apis/rest/ready

Copilot/Claude で試す

List all applications
List 5 transactions for application <YourApp>
List available applications datagraphs
List applications insights

---

ツールセットとツール

サーバーは機能を ツールセット に整理します。

利用可能なツールセット

ツールセット	説明
Portfolio Tools	ポートフォリオレベルでの調査：アプリケーションの一覧表示、メトリクスの比較、システム全体のホットスポットのスキャン。
Applications Tools	アプリケーションレベルの分析：トランザクション、品質問題、データグラフ、アーキテクチャ。
Objects Tools	オブジェクト要素の調査：オブジェクト、参照、呼び出し元／呼び出し先の特定。

ツール

ポートフォリオ

• applications — CAST Imaging で利用可能なアプリケーションを一覧表示します
• all_applications — すべてのアプリケーションを一覧表示します（クラウドビルド）
• my_applications — 現在のユーザーに属するアプリケーションを一覧表示します（クラウドビルド）
• applications_transactions — フィルタリングに対応して、すべてのアプリケーションのトランザクションを取得します
• applications_data_graphs — すべてのアプリケーションのデータエンティティ間の相互作用ネットワーク（データグラフ）
• applications_dependencies — すべてのアプリケーション間の相互依存関係
• applications_quality_insights — CVE、クラウド検出パターン、グリーン検出パターンを含む品質インサイト
• get_mcp_info — MCP サーバーおよび Imaging のバージョン／環境情報を取得します

アプリケーション

- **application_database_explorer** — アプリケーションのデータベーステーブルとカラムを調べます - **stats** — アプリケーションの基本的な統計情報を取得します - **architectural_graph** — 指定したレベル（レイヤー、コンポーネント、サブコンポーネント、技術カテゴリ、要素タイプ）のアーキテクチャグラフデータ（ノード／リンク）を取得します - **architectural_graph_focus** — 特定の領域に焦点を当てたアーキテクチャグラフデータを取得します - **quality_insights** — 品質に関するインサイト（CVE、クラウドパターン、グリーンパターン、構造上の欠陥、ISO-5055）を取得します - **quality_insight_violations** — 品質インサイトに関する特定の違反を ID で取得します。場所は任意で指定できます - **packages** — パッケージ情報と依存関係を取得します - **package_interactions** — コンポーネントとバージョンごとに、特定のパッケージとの相互作用を取得します - **transaction_profiles** — 利用可能なトランザクションプロファイルを取得します - **transactions** — 名前、フルネーム、タイプによる任意のフィルタリングを使用して、トランザクションを取得します - **transaction_details** — ID で指定したトランザクションに関する詳細情報を取得します - **add_view_document** — トランザクションまたはデータグラフにドキュメントを追加します - **data_graphs** — 任意のフィルタリングを使用して、データエンティティの相互作用ネットワーク（データグラフ）を取得します - **data_graph_profiles** — 利用可能なデータグラフプロファイルを取得します - **data_graph_details** — ID で指定したデータグラフに関する詳細情報を取得します - **inter_applications_dependencies** — アプリケーション間の内向きおよび外向きの依存関係を取得します - **inter_app_detailed_dependencies** — 指定した 2 つのアプリケーション間の詳細な依存関係を取得します - **advisor_occurrences** — 選択したアドバイザーを裏付ける出現箇所を取得します - **application_iso_5055_explorer** — ISO 5055 の特性と弱点を調べます - **api_inventory** — アプリケーションの API インベントリを取得します - **advisors** — 移行／モダナイゼーションのアドバイザー、ルール、違反を取得します - **dynamic_views** — カスタム集約ビューを一覧表示します - **dynamic_view_details** — カスタムビューのグラフ、またはカスタムノード内のオブジェクトを取得します - **manage_dynamic_view** — カスタムビューの作成、削除、名前変更、公開、または非公開化を行います - **configure_dynamic_view** — カスタムビュー内のカスタムノードを追加または削除します - **views** — 保存済みビューを一覧表示します - **view_details** — 保存済みビューの詳細を取得します - **manage_view** — 保存済みビューの作成、更新、または削除を行います - **tags** — アプリケーションで利用可能なタグを一覧表示します

オブジェクト

• objects — 識別条件（名前、フルネーム、マングリング、タイプ、ファイルパス）に一致するアプリケーション内のオブジェクトを取得します
• object_profiles — 利用可能なオブジェクトプロファイルを取得します
• object_details — プロパティ、関係、コードスニペット、使用統計を含むオブジェクトの包括的な詳細を取得します
• add_object_document — ID で指定したオブジェクトにドキュメントテキストを追加します
• manage_object_tags — 明示的に指定したオブジェクトのタグを追加または削除します
• bulk_manage_object_tags — サーバー側の条件で選択したオブジェクトのタグを追加または削除します
• objects_relationships — 複数のオブジェクト間の関係を検索します
• pathfinder_hierarchy_details — 実行パス、呼び出しチェーン、階層の詳細を検索します
• source_files — ファイルパス条件に一致するコードオブジェクトを定義しているソースファイルを検索します
• source_file_details — ソースファイルとそのコード要素に関する詳細情報（インベントリ、内向き、外向き、テスト）を取得します
• transactions_using_object — 指定した条件に一致するオブジェクトを使用するトランザクションを取得します
• data_graphs_involving_object — 特定のオブジェクトが関与するデータエンティティの相互作用ネットワーク（データグラフ）を取得します

構造検索（intents プロファイル）

• get_structural_search_function_syntax — 構造検索関数の構文と使用方法の詳細を取得します
• run_structural_search_function — 汎用ディスパッチャーを介して構造検索関数を実行します

---

トラブルシューティング

症状	考えられる原因	対処方法
クライアントで ECONNREFUSED が発生する	サーバーが起動していない	docker ps を実行し、続いて ./run.sh --install で起動します
認証エラー	Imaging API キーが間違っている、または期限切れ	Imaging プロファイルからキーを再生成します
回答が空になる	Imaging‑APIs に到達できない	HOST_CONTROL_PANEL ／ PORT_CONTROL_PANEL とヘルスエンドポイントを再確認します
HTTPS のハンドシェイク／エラー	Control Panel の証明書がプライベート証明書または自己署名証明書	CONTROL_PANEL_SSL_ENABLED=true を設定し、SSL_CA_BUNDLE を構成します
VS Code でキーの入力が求められない	mcp.json に inputs がない	inputs ブロックを追加します（セットアップを参照）

ログと確認

# Server logs
docker logs <mcp-container-id>

# Re‑verify Imaging‑APIs
curl -H "x-api-key: <your-key>"      http://{CONTROL_PANEL_HOST}:8090/imaging/apis/rest/ready

---

セキュリティに関する注意事項

• IMAGING_CODE はデフォルトで False：有効にすると MCP クライアントがソースコードにアクセスできるようになるため、ポリシー、ネットワーク、認証情報で制限してください。
• プライベート CA には SSL_CA_BUNDLE を使用：TLS 検証を無効にするのではなく、CA バンドルを使用してください。
• 最小権限の原則：MCP ホストで Imaging API キーを取得・入力できるユーザーを制限してください。

---

パッケージの内容

com.castsoftware.imaging.mcpserver.docker.__MCP_VERSION__/
├─ config/app.config
├─ docker-compose.yml
├─ run.sh
├─ .env                      # hidden
├─ README.md                 # original docs
└─ copilot-instructions.md   # optional, copy to .github/

---

サポート

• コンテナログと Imaging‑APIs のヘルスエンドポイントを確認します
• app.config、.env、mcp.json のパスと値を検証します
• クライアント ↔ サーバー ↔ Imaging‑APIs 間のネットワーク接続を確認します

---

ライセンス

このリポジトリにはドキュメントのみが含まれています。
プロジェクトのソースコードはプロプライエタリであり、オープンソースライセンスのもとでは公開されていません。

• ソースコードは別途商用ライセンスのもとでライセンスされており、このリポジトリには含まれていません。
• このリポジトリを通じてソースコードに関する権利が付与されることはありません。
• このドキュメントは自由に閲覧・共有できますが、プロプライエタリソフトウェアの権利を推測したり、権利があると示唆したりする目的で使用することはできません。

商用ライセンスに関するお問い合わせは、お近くの CAST 担当者までご連絡ください（https://www.castsoftware.com/overview）。

---