hawa-sqlite-mcp

基于 MCP (Model Context Protocol) 的 SQLite 数据库服务，通过 stdio 传输，提供表结构查询与 SQL 执行能力。

构建

npm install
npm run build

构建产物为 dist/index.js（better-sqlite3 为外部依赖，随 npm install 安装）。

MCP 客户端配置

包已发布到 npm（@dahawa/hawa-sqlite-mcp），通过 npx 直接运行，无需本地构建。

Claude Desktop / Cursor 等

{
  "mcpServers": {
    "sqlite": {
      "command": "npx",
      "args": [
        "-y",
        "@dahawa/hawa-sqlite-mcp",
        "/absolute/path/to/data.sqlite"
      ]
    }
  }
}

通过环境变量指定数据库路径

{
  "mcpServers": {
    "sqlite": {
      "command": "npx",
      "args": ["-y", "@dahawa/hawa-sqlite-mcp"],
      "env": {
        "SQLITE_DB_PATH": "/absolute/path/to/data.sqlite"
      }
    }
  }
}

数据库路径优先级：SQLITE_DB_PATH 环境变量 > args 中的命令行参数 > 默认 ./data.sqlite（相对 MCP 客户端工作目录）。若客户端找不到 npx/node，可改用 which node 查到的绝对路径。

工具一览

| 工具 | 说明 | |---|---| | list_tables | 列出所有表/视图，可选包含 CREATE DDL 与列结构 | | execute_ddl | 执行 DDL 语句（CREATE / ALTER / DROP，支持多语句批执行） | | execute_sql | 执行 SQL（SELECT / INSERT / UPDATE / DELETE），支持 ? 参数绑定 |