SQLite数据库检查工具

一款通过ADB检查和查询Android设备上SQLite数据库的MCP服务器工具。

  • by hortusys
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 hortusys/android-sqlite-inspector

使用说明

安卓SQLite检查器

MCP服务器,通过ADB检查和查询Android设备上的SQLite数据库。

先决条件

  • Node.js 18+
  • ADB已安装并位于PATH中
  • A. 可调试的 Android应用程序(调试版本)

安装

npm install
npm run build

配置

通过环境变量设置:

变量 描述 默认值
ANDROID_PACKAGE 应用程序包名称 com.hortusys
ANDROID_DEVICE ADB设备序列号(适用于多个设备) (自动检测)
ADB_PATH ADB二进制文件的自定义路径 adb

Claude代码设置

添加 ~/.claude/settings.json:

{
  "mcpServers": {
    "android-sqlite-inspector": {
      "command": "node",
      "args": ["/Users/andromeda/StudioProjects/android-sqlite-inspector/dist/index.js"],
      "env": {
        "ANDROID_PACKAGE": "com.hortusys"
      }
    }
  }
}

可用工具

工具 说明
list_databases 列出全部 .db 应用程序数据库目录中的文件
list_tables 列出数据库中的所有表
describe_table 显示表的列架构
query 执行SELECT查询(返回JSON)
execute 执行INSERT/UPDATE/DELETE(将更改推回设备)

运作原理

  1. 每次读取操作都会通过以下方式从设备中提取数据库的新副本 adb shell run-as <package> cat databases/<db>
  2. 查询在本地运行,使用 better-sqlite3
  3. 写入操作(execute)拉取数据库,在本地修改,然后通过ADB推回