安卓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(将更改推回设备) |
运作原理
- 每次读取操作都会通过以下方式从设备中提取数据库的新副本 `adb shell run-as
cat databases/`
- 查询在本地运行,使用
better-sqlite3 - 写入操作(
execute)拉取数据库,在本地修改,然后通过ADB推回
