SuperAPI AI 工具集

install-dexsql

部署与运维

查看项目

更新于 10-24 16:15

技能介绍

用途:本技能引导完成 DexSQL MCP 的本地安装与客户端接入,最终得到可用的本地 DexSQL MCP 连接。DexSQL 为闭源产品,只能安装预编译可执行文件,不能从源码构建。服务器以 dexsql mcp 通过 stdio 运行,不需要 JVM、GUI 或 Python 运行时;这是纯本地 stdio 服务,无需网络监听或 API 密钥。

版本与资产选择:先检测主机操作系统和架构、目标 MCP 客户端以及已有的 DexSQL 可执行文件或配置。若本地客户端明确则推断使用它,仅在目标客户端或范围确实不明确时询问。除非用户要求更新,优先使用兼容的现有可执行文件;也支持用户提供的本地可执行文件,配置前应检查 --version 和 mcp --help。否则查看 GitHub API 的最新发布资产,或指定标签的发布资产;按实际资产的 browser_download_url 选择对应操作系统与架构的 CLI 可执行文件或压缩包,不得用 WASM 包、源码包或其他项目的二进制替代,也不得臆造资产名称。可用平台、架构、打包方式和系统要求以该发布的实际资产与说明为准,下载前检查与主机的兼容性。若仓库不可访问、无发布或没有匹配的二进制,应说明具体问题,并接受用户提供的本地可执行文件或官方发布 URL,不得声称安装成功或尝试构建闭源引擎。

安装:下载到临时目录。若发布资产 API 提供 sha256:<hex> 形式的摘要,运行或安装前与下载文件的 SHA-256 比对;官方校验和文件也是可接受来源。不匹配即停止。两者都没有时,将计算的哈希作为本地指纹报告,而非经验证的上游校验和。独立可执行文件无需解压;压缩包仅在临时目录内解压且所有条目保留在其中。将可执行文件及其许可证/声明放入版本化、用户可写目录,例如 Windows 的 %LOCALAPPDATA%/DexSQL/<version>/,macOS/Linux 的 ~/.local/share/dexsql/<version>/。MCP 配置中使用绝对路径,无需管理员权限或修改 shell PATH。安装文件名规范为 Windows 的 dexsql.exe 或 macOS/Linux 的 dexsql。纯二进制需在可执行文件旁保留 LICENSE 和 LICENSE-AUXILIARY;优先使用同一发布的资产及其 URL 与摘要。若这两个文件不是发布资产,则使用所选发布的实际 tag_name 从 raw.githubusercontent.com 获取,而非默认分支。LICENSE 必需;该版本提供 LICENSE-AUXILIARY 时一并保留。第三方声明压缩在可执行文件内,无需单独下载;如需可读副本,运行 dexsql extract licenses --output THIRD_PARTY_NOTICES 离线导出完整 UTF-8 文本,该命令拒绝覆盖已有文件。macOS/Linux 上确保可执行位已设置,新可执行文件通过验证前保留现有安装;不得为强制运行不兼容或被阻止的二进制而禁用操作系统安全检查。

客户端连接:检查相关现有配置并保留无关服务器与设置。新连接添加名为 dexsql 的服务器;更新时仅修改该服务器的可执行文件路径,除非用户要求其他更改,保留自定义参数、环境设置和超时。编辑配置文件前先备份,已正确的条目无需重写。对 Codex,新条目优先使用其 CLI:codex mcp add dexsql -- /absolute/path/to/dexsql mcp,然后用 codex mcp get dexsql --json 检查;CLI 不可用时将 [mcp_servers.dexsql] 表合并进所选 Codex 配置文件。对使用 mcpServers JSON 的客户端,将 dexsql 条目合并到其文档所述配置位置或使用其 MCP 设置界面。Windows 路径需正确进行 JSON/TOML 转义;不要假设所有客户端使用相同配置路径或结构,也不要为完成任务额外安装其他 AI 客户端。

验证与交付:运行 --version,然后在可用时通过客户端验证 MCP initialize 握手与 tools/list,或使用临时 stdio MCP 探测,工具列表须包含 open_dataset、query 和 decode,探测后关闭。仅注册配置不算成功的连接测试。若客户端需要重启或新会话才能发现服务器,应将其与已验证的可执行文件/协议状态分开说明;在其工具可用前不得声称当前会话已连接。仅在用户要求时分析 APK,安装无需打开其文件。报告已安装版本、可执行文件路径、配置位置、验证结果及剩余客户端重载步骤。推荐首条提示词为:“Open this APK with DexSQL, find methods referencing this string, and show their callers and Smali.”