PT Application Inspector MCP

@posidev-community/ptai-mcp

PT Application Inspector MCP 用のスタンドアロン CLI ランチャーです。

公開時の識別子

公開 npm パッケージと MCP Registry のエントリーでは、意図的に異なる 識別子を使用しています。

対象	識別子
npm パッケージ	@posidev-community/ptai-mcp
Official MCP Registry	io.github.POSIdev-community/ptai-mcp
ローカルエージェント設定キー	ptai_analyzer

server.json は MCP Registry マニフェストです。クライアントが npm パッケージを検出して起動する方法を記述したものであり、ランタイム時にランチャーが読み込むファイルではありません。

必要条件

• Node.js 18 以降
• プラットフォーム固有のバンドルディレクトリにインストールされた PT Application Inspector バンドル

使用方法

npm でパッケージをインストールし、MCP を起動します。

npx @posidev-community/ptai-mcp start

MCP がインストールされていない場合、start コマンドはすぐに失敗します。次のコマンドでアナライザーバンドルをダウンロードしてインストールします。

npx @posidev-community/ptai-mcp install

インストールでは、実行中のアナライザープロセスを停止し、設定済みのバンドルをダウンロードして、プラットフォームのバンドルディレクトリに展開します。まず本番環境のエンドポイントを確認します。開発ビルドは PT テスト用エンドポイントからのみ入手できる場合があります。その後、configure でエージェント設定を管理できます。

信頼できる PT インストーラーのエンドポイントのいずれかが信頼されていない TLS 証明書を提示した場合、CLI は、そのダウンロードに限って証明書の検証を無効にする前に、明示的な確認を求めます。信頼できる非対話型の開発環境では、同じ選択を PTAI_MCP_ALLOW_INSECURE_TLS=1 で明示できます。

PTAI_MCP_ALLOW_INSECURE_TLS=1 npx @posidev-community/ptai-mcp install

$env:PTAI_MCP_ALLOW_INSECURE_TLS = '1'
npx @posidev-community/ptai-mcp install

信頼できないエンドポイントや通常の本番環境で、この変数を設定しないでください。

その他のコマンド：

npx @posidev-community/ptai-mcp configure
npx @posidev-community/ptai-mcp update
npx @posidev-community/ptai-mcp status
npx @posidev-community/ptai-mcp uninstall

configure では、Cursor、Claude Desktop、Claude Code、Windsurf、Kimi Code、Codex、Antigravity、Gemini CLI、OpenCode について、MCP とフックを個別に選択できます。既存の JSON／JSONC／TOML 設定や、無関係なフックは保持されます。エージェント設定は Windows、macOS、Linux でサポートされています。設定ディレクトリが検出されたエージェントのみが表示されます。まず MCP サーバーを選択し、次のフック設定では、フックをサポートする選択済みのエージェントのみが一覧表示されます。Space キーで選択を切り替え、Enter キーで確定します。エージェントの選択を解除すると、そのエージェントの設定から PTAI が所有するエントリーのみが削除されます。選択が空の場合、追加の確認プロンプトなしですぐに適用されます。

同じメニューから、カスタムエージェントのセットアップガイドを ~/.ptai-mcp/PT_AI_Custom_Agent_Setup.md に生成し、開くこともできます。このガイドには、組み込みアダプターのないクライアント向けの MCP、フック、エージェントルールの例が含まれています。

start の後に指定した追加の引数は、McpProxy に直接渡されます。

npx @posidev-community/ptai-mcp start --stdio

CLI は versions.json も確認し、インストール済みバンドルのバージョンが、このパッケージで想定されているバンドルのバージョンと異なる場合に警告します。

バンドルの場所

プラットフォーム	ディレクトリ
Windows	%LOCALAPPDATA%\Application Inspector Analyzer
Linux	~/application-inspector-analyzer
macOS	/Library/Application-Inspector-Analyzer

MCP 実行ファイル名は、Windows では McpProxy.exe、Linux／macOS では McpProxy です。

ローカルでの実行

ソースツリーから実行

依存関係をインストールし、CLI をビルドして、エントリーポイントを直接呼び出します。

npm ci
npm run build
node ./bin/ptai-mcp.js --help

起動する前にアナライザーバンドルをインストールします。

node ./bin/ptai-mcp.js install
node ./bin/ptai-mcp.js configure
node ./bin/ptai-mcp.js status
node ./bin/ptai-mcp.js start

Windows PowerShell では、同等のエントリーポイントは node .\bin\ptai-mcp.js です。

ローカルの npm アーティファクトから

まず、公開可能なアーカイブをビルドします。

npm run artifact

npm pack に表示されるファイル名を使用します（現在のバージョンでは posidev-community-ptai-mcp-1.0.0.tgz が生成されます）。

npm exec --yes --package=./posidev-community-ptai-mcp-1.0.0.tgz -- ptai-mcp --help
npm exec --yes --package=./posidev-community-ptai-mcp-1.0.0.tgz -- ptai-mcp install
npm exec --yes --package=./posidev-community-ptai-mcp-1.0.0.tgz -- ptai-mcp configure
npm exec --yes --package=./posidev-community-ptai-mcp-1.0.0.tgz -- ptai-mcp status
npm exec --yes --package=./posidev-community-ptai-mcp-1.0.0.tgz -- ptai-mcp start

Windows PowerShell では、ローカルパス形式を使用します。

npm exec --yes --package=.\posidev-community-ptai-mcp-1.0.0.tgz -- ptai-mcp --help

configure によって生成されるエージェント設定では、公開済みのパッケージ名を npx 経由で使用するため、この設定によるエージェントの自動起動には、パッケージが npm レジストリで利用可能である必要があります。

ライセンス

この npm パッケージのソースコードは MIT License の下でライセンスされています。詳細は LICENSE を参照してください。

install および update によってダウンロードされる PT Application Inspector のアナライザーバンドル（McpProxy および付属コンポーネントを含む）はプロプライエタリソフトウェアであり、MIT License の対象ではありません。その使用には、該当する Positive Technologies のライセンス契約が適用されます。このパッケージは、そのバンドルの使用、変更、再配布に関する追加の権利を付与するものではありません。

開発

npm install
npm run build

テストスイートを実行するには、次のコマンドを使用します。

npm test

適用されるカバレッジしきい値を設定してテストスイートを実行し、HTML レポートを生成するには、次のコマンドを使用します。

npm run test:coverage

公開前に、リリース検証をすべて実行します。

npm run verify

公開可能な npm アーティファクトをローカルでビルドします。

npm run artifact

これにより、完全な検証を先に実行し、リポジトリのルートに .tgz パッケージを作成します。生成されたアーカイブはリリースアーティファクトであり、Git の対象外です。

クリーンな一時 npm インストール環境で、パッケージ化されたアーティファクトを検証します。

npm run smoke:artifact

パッケージのバージョンが唯一の信頼できる情報源です。server.json はパッケージ化の際に package.json から同期され、npm run verify によってチェックされます。また、マニフェストは、MCP Registry の名前が package.json.mcpName と一致し、npm パッケージのエントリーがパッケージ名とバージョンに一致することもチェックします。