PT Application Inspector MCP

@posidev-community/ptai-mcp

PT Application Inspector MCP 的独立 CLI 启动器。

发布标识

公开的 npm 包和 MCP Registry 条目有意使用不同的标识符：

发布渠道	标识符
npm 包	@posidev-community/ptai-mcp
官方 MCP Registry	io.github.POSIdev-community/ptai-mcp
本地 Agent 配置键	ptai_analyzer

server.json 是 MCP Registry 清单。它描述客户端如何发现并启动 npm 包；启动器在运行时不会读取该文件。

要求

• Node.js 18 或更高版本
• 在平台专用的 bundle 目录中安装 PT Application Inspector bundle

用法

使用 npm 安装该包并启动 MCP：

npx @posidev-community/ptai-mcp start

如果未安装 MCP，start 命令会立即失败。下载并安装分析器 bundle：

npx @posidev-community/ptai-mcp install

安装时会停止正在运行的分析器进程，下载配置的 bundle，并将其解压到平台 bundle 目录。首先会检查生产环境端点；开发版本可能只能从 PT 测试端点获取。之后可以通过 configure 管理 Agent 配置。

如果受信任的 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 和 hooks 选项。现有 JSON/JSONC/TOML 设置以及无关的 hooks 均会保留。Windows、macOS 和 Linux 均支持 Agent 配置。仅显示检测到配置目录的 Agent。首先选择 MCP 服务；随后 hooks 步骤只会列出所选且支持 hooks 的 Agent。按空格键切换选择，按 Enter 确认。取消选择某个 Agent 时，只会从该 Agent 的配置中移除 PTAI 管理的条目。若未选择任何项目，会立即应用，不会额外提示确认。

同一菜单还可以生成自定义 Agent 设置指南，并提供打开选项。指南位于 ~/.ptai-mcp/PT_AI_Custom_Agent_Setup.md，其中包含适用于没有内置适配器的客户端的 MCP、hooks 和 Agent 规则示例。

start 后的其他参数会直接传递给 McpProxy：

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

CLI 还会检查 versions.json，并在已安装的 bundle 版本与此包预期的 bundle 版本不一致时发出警告。

Bundle 位置

平台	目录
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

启动前请安装分析器 bundle：

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 生成的 Agent 配置通过 npx 使用已发布的包名，因此，要通过该配置自动启动 Agent，包必须已在 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

包版本是唯一事实来源。打包时会根据 package.json 同步 server.json，并由 npm run verify 检查。清单还会检查其 MCP Registry 名称是否与 package.json.mcpName 匹配，以及其 npm 包条目是否与包名和版本匹配。