easy-sqlite-mcp 1.0.1

package/README.md

@@ -0,0 +1,66 @@
+# Easy SQLite MCP
+
+A [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) server implemented in Node.js and TypeScript, designed to enable LLMs to interact directly with SQLite databases.
+
+## Features
+
+This server provides 7 core tools covering all requirements from connection management to data querying:
+
+1.  **Connection Management**:
+    *   `sqlite_open`: Open a specific SQLite database file path.
+    *   `sqlite_close`: Close the current database connection.
+    *   `sqlite_status`: Check connection status, file path, and database summary.
+2.  **Data Operations**:
+    *   `sqlite_query`: Execute read-only `SELECT` queries and return results in a structured format.
+    *   `sqlite_execute`: Execute write or modification operations (e.g., `INSERT`, `UPDATE`, `DELETE`, `CREATE`, `DROP`).
+3.  **Schema Discovery**:
+    *   `sqlite_list_tables`: List all user-defined tables in the database.
+    *   `sqlite_describe_table`: Get column information, types, and total row count for a specific table.
+
+## Installation and Execution
+
+### 1. Run via npx
+If the project is published on npm, you can start it directly using `npx` without prior installation:
+```bash
+npx easy-sqlite-mcp
+```
+
+### 2. Local Development and Build
+To develop locally or build from source, follow these steps:
+```bash
+npm install
+npm run build
+npm run dev # Watch for changes and run in development mode
+```
+
+## MCP Client Configuration
+
+To use this with Claude Desktop or other MCP-compatible clients, add the following to your configuration:
+
+```json
+{
+  "mcpServers": {
+    "easy-sqlite-mcp": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "easy-sqlite-mcp"
+      ]
+    }
+  }
+}
+```
+
+## Agent Skills (`/skills`)
+
+The `/skills` directory contains Agent Skills designed to work in conjunction with this MCP Server. These skill documents provide Large Language Models (LLMs) with the knowledge of how to use this server for professional, high-level database operations. You can add these skills to your AI agent's workspace.
+
+## Tech Stack
+- **Runtime**: Node.js (>= 18)
+- **Language**: TypeScript
+- **SDK**: @modelcontextprotocol/sdk
+- **Database**: better-sqlite3 (High performance with support for synchronous operations)
+- **Validation**: Zod (Strict parameter validation)
+
+---
+Developed with the assistance of Antigravity.

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+/**
+ * SQLite MCP Server
+ *
+ * This server provides tools to interact with SQLite databases via
+ * the Model Context Protocol (MCP). It supports opening/closing databases,
+ * querying, executing statements, listing tables, and describing schemas.
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;GAMG"}

package/dist/index.js

@@ -0,0 +1,29 @@
+#!/usr/bin/env node
+/**
+ * SQLite MCP Server
+ *
+ * This server provides tools to interact with SQLite databases via
+ * the Model Context Protocol (MCP). It supports opening/closing databases,
+ * querying, executing statements, listing tables, and describing schemas.
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { registerSqliteTools } from "./tools/sqlite.js";
+// Create MCP server instance
+const server = new McpServer({
+    name: "easy-sqlite-mcp",
+    version: "1.0.0",
+});
+// Register all SQLite tools
+registerSqliteTools(server);
+// Start the server with stdio transport
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("SQLite MCP server running via stdio");
+}
+main().catch((error) => {
+    console.error("Server error:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;GAMG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAExD,6BAA6B;AAC7B,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;IAC3B,IAAI,EAAE,iBAAiB;IACvB,OAAO,EAAE,OAAO;CACjB,CAAC,CAAC;AAEH,4BAA4B;AAC5B,mBAAmB,CAAC,MAAM,CAAC,CAAC;AAE5B,wCAAwC;AACxC,KAAK,UAAU,IAAI;IACjB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC;AACvD,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,eAAe,EAAE,KAAK,CAAC,CAAC;IACtC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/services/sqlite-manager.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Manages a single SQLite database connection.
+ */
+export declare class SqliteManager {
+    private db;
+    private filePath;
+    /**
+     * Open an SQLite database file.
+     */
+    open(filePath: string): {
+        success: boolean;
+        message: string;
+    };
+    /**
+     * Close the current database connection.
+     */
+    close(): {
+        success: boolean;
+        message: string;
+    };
+    /**
+     * Get the current database status.
+     */
+    status(): {
+        isOpen: boolean;
+        filePath: string | null;
+        memoryUsage: number | null;
+        tables: number | null;
+    };
+    /**
+     * Execute a read-only SELECT query.
+     */
+    query(sql: string, params?: Record<string, unknown>): {
+        columns: string[];
+        rows: unknown[][];
+        rowCount: number;
+    };
+    /**
+     * Execute a write operation (INSERT, UPDATE, DELETE, CREATE, DROP, ALTER).
+     */
+    execute(sql: string, params?: Record<string, unknown>): {
+        changes: number;
+        lastInsertRowid: number | bigint;
+    };
+    /**
+     * List all tables in the database.
+     */
+    listTables(): {
+        tables: string[];
+    };
+    /**
+     * Describe the schema of a specific table.
+     */
+    describeTable(tableName: string): {
+        name: string;
+        columns: {
+            cid: number;
+            name: string;
+            type: string;
+            notnull: boolean;
+            defaultValue: unknown;
+            pk: boolean;
+        }[];
+        rowCount: number;
+    };
+    /**
+     * Ensure the database is open before running a query.
+     */
+    private ensureOpen;
+}
+//# sourceMappingURL=sqlite-manager.d.ts.map

package/dist/services/sqlite-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-manager.d.ts","sourceRoot":"","sources":["../../src/services/sqlite-manager.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,EAAE,CAAkC;IAC5C,OAAO,CAAC,QAAQ,CAAuB;IAEvC;;OAEG;IACH,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;IAqB7D;;OAEG;IACH,KAAK,IAAI;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;IAmB9C;;OAEG;IACH,MAAM,IAAI;QACR,MAAM,EAAE,OAAO,CAAC;QAChB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;QACxB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;QAC3B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;KACvB;IAyBD;;OAEG;IACH,KAAK,CACH,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B;QAAE,OAAO,EAAE,MAAM,EAAE,CAAC;QAAC,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE;IAkB7D;;OAEG;IACH,OAAO,CACL,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE;IAYxD;;OAEG;IACH,UAAU,IAAI;QAAE,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE;IAUlC;;OAEG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG;QAChC,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE;YACP,GAAG,EAAE,MAAM,CAAC;YACZ,IAAI,EAAE,MAAM,CAAC;YACb,IAAI,EAAE,MAAM,CAAC;YACb,OAAO,EAAE,OAAO,CAAC;YACjB,YAAY,EAAE,OAAO,CAAC;YACtB,EAAE,EAAE,OAAO,CAAC;SACb,EAAE,CAAC;QACJ,QAAQ,EAAE,MAAM,CAAC;KAClB;IAoCD;;OAEG;IACH,OAAO,CAAC,UAAU;CAOnB"}

package/dist/services/sqlite-manager.js

@@ -0,0 +1,141 @@
+import Database from "better-sqlite3";
+/**
+ * Manages a single SQLite database connection.
+ */
+export class SqliteManager {
+    db = null;
+    filePath = null;
+    /**
+     * Open an SQLite database file.
+     */
+    open(filePath) {
+        try {
+            // Close existing connection if any
+            if (this.db) {
+                this.close();
+            }
+            this.db = new Database(filePath);
+            // Enable WAL mode for better concurrency
+            this.db.pragma("journal_mode = WAL");
+            this.filePath = filePath;
+            return { success: true, message: `Database opened: ${filePath}` };
+        }
+        catch (error) {
+            return {
+                success: false,
+                message: `Failed to open database: ${error instanceof Error ? error.message : String(error)}`,
+            };
+        }
+    }
+    /**
+     * Close the current database connection.
+     */
+    close() {
+        if (!this.db) {
+            return { success: false, message: "No database is currently open." };
+        }
+        try {
+            this.db.close();
+            const closedPath = this.filePath;
+            this.db = null;
+            this.filePath = null;
+            return { success: true, message: `Database closed: ${closedPath}` };
+        }
+        catch (error) {
+            return {
+                success: false,
+                message: `Failed to close database: ${error instanceof Error ? error.message : String(error)}`,
+            };
+        }
+    }
+    /**
+     * Get the current database status.
+     */
+    status() {
+        if (!this.db) {
+            return { isOpen: false, filePath: null, memoryUsage: null, tables: null };
+        }
+        let tableCount = null;
+        try {
+            const result = this.db
+                .prepare("SELECT COUNT(*) as count FROM sqlite_master WHERE type='table' AND name NOT LIKE 'sqlite_%'")
+                .get();
+            tableCount = result.count;
+        }
+        catch {
+            // ignore
+        }
+        return {
+            isOpen: true,
+            filePath: this.filePath,
+            memoryUsage: null,
+            tables: tableCount,
+        };
+    }
+    /**
+     * Execute a read-only SELECT query.
+     */
+    query(sql, params) {
+        this.ensureOpen();
+        const stmt = this.db.prepare(sql);
+        const rows = params ? stmt.all(params) : stmt.all();
+        if (rows.length === 0) {
+            return { columns: [], rows: [], rowCount: 0 };
+        }
+        const columns = Object.keys(rows[0]);
+        const dataRows = rows.map((row) => columns.map((col) => row[col]));
+        return { columns, rows: dataRows, rowCount: rows.length };
+    }
+    /**
+     * Execute a write operation (INSERT, UPDATE, DELETE, CREATE, DROP, ALTER).
+     */
+    execute(sql, params) {
+        this.ensureOpen();
+        const stmt = this.db.prepare(sql);
+        const result = params ? stmt.run(params) : stmt.run();
+        return {
+            changes: result.changes,
+            lastInsertRowid: result.lastInsertRowid,
+        };
+    }
+    /**
+     * List all tables in the database.
+     */
+    listTables() {
+        this.ensureOpen();
+        const rows = this.db.prepare("SELECT name FROM sqlite_master WHERE type='table' AND name NOT LIKE 'sqlite_%' ORDER BY name").all();
+        return { tables: rows.map((r) => r.name) };
+    }
+    /**
+     * Describe the schema of a specific table.
+     */
+    describeTable(tableName) {
+        this.ensureOpen();
+        const columns = this.db.prepare(`PRAGMA table_info('${tableName}')`).all();
+        if (columns.length === 0) {
+            throw new Error(`Table '${tableName}' not found.`);
+        }
+        const countResult = this.db.prepare(`SELECT COUNT(*) as count FROM "${tableName}"`).get();
+        return {
+            name: tableName,
+            columns: columns.map((col) => ({
+                cid: col.cid,
+                name: col.name,
+                type: col.type,
+                notnull: col.notnull === 1,
+                defaultValue: col.dflt_value,
+                pk: col.pk === 1,
+            })),
+            rowCount: countResult.count,
+        };
+    }
+    /**
+     * Ensure the database is open before running a query.
+     */
+    ensureOpen() {
+        if (!this.db) {
+            throw new Error("No database is currently open. Use sqlite_open to open a database first.");
+        }
+    }
+}
+//# sourceMappingURL=sqlite-manager.js.map

package/dist/services/sqlite-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-manager.js","sourceRoot":"","sources":["../../src/services/sqlite-manager.ts"],"names":[],"mappings":"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"}

package/dist/tools/sqlite.d.ts

@@ -0,0 +1,6 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/**
+ * Register all SQLite tools on the MCP server.
+ */
+export declare function registerSqliteTools(server: McpServer): void;
+//# sourceMappingURL=sqlite.d.ts.map

package/dist/tools/sqlite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite.d.ts","sourceRoot":"","sources":["../../src/tools/sqlite.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAMpE;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAmS3D"}

package/dist/tools/sqlite.js

@@ -0,0 +1,269 @@
+import { z } from "zod";
+import { SqliteManager } from "../services/sqlite-manager.js";
+const sqliteManager = new SqliteManager();
+/**
+ * Register all SQLite tools on the MCP server.
+ */
+export function registerSqliteTools(server) {
+    // ─── sqlite_open ───────────────────────────────────────────────
+    server.registerTool("sqlite_open", {
+        title: "Open SQLite Database",
+        description: `Open an SQLite database file at the specified path.
+
+Args:
+  - file_path (string): Absolute or relative path to the .db / .sqlite file.
+
+Returns:
+  { "success": boolean, "message": string }
+
+Examples:
+  - "Open the users database" -> file_path="/data/users.db"
+
+Error Handling:
+  - Returns success=false with message if the file cannot be opened.`,
+        inputSchema: {
+            file_path: z
+                .string()
+                .min(1, "file_path is required")
+                .describe("Path to the SQLite database file"),
+        },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    }, async ({ file_path }) => {
+        const result = sqliteManager.open(file_path);
+        return {
+            content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+            structuredContent: result,
+        };
+    });
+    // ─── sqlite_close ──────────────────────────────────────────────
+    server.registerTool("sqlite_close", {
+        title: "Close SQLite Database",
+        description: `Close the currently open SQLite database connection.
+
+Returns:
+  { "success": boolean, "message": string }
+
+Error Handling:
+  - Returns success=false if no database is currently open.`,
+        inputSchema: {},
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    }, async () => {
+        const result = sqliteManager.close();
+        return {
+            content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+            structuredContent: result,
+        };
+    });
+    // ─── sqlite_status ─────────────────────────────────────────────
+    server.registerTool("sqlite_status", {
+        title: "SQLite Database Status",
+        description: `Get the current status of the SQLite database connection.
+
+Returns:
+  {
+    "isOpen": boolean,
+    "filePath": string | null,
+    "memoryUsage": number | null,
+    "tables": number | null
+  }`,
+        inputSchema: {},
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    }, async () => {
+        const result = sqliteManager.status();
+        return {
+            content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+            structuredContent: result,
+        };
+    });
+    // ─── sqlite_query ──────────────────────────────────────────────
+    server.registerTool("sqlite_query", {
+        title: "Query SQLite Database",
+        description: `Execute a read-only SQL query (SELECT) on the currently open database.
+
+Args:
+  - sql (string): The SQL SELECT statement to execute.
+  - params (object, optional): Named parameters for the query (e.g. { ":id": 1 }).
+
+Returns:
+  { "columns": string[], "rows": unknown[][], "rowCount": number }
+
+Error Handling:
+  - Throws if no database is open. Use sqlite_open first.
+  - Returns SQL error message if the query is invalid.`,
+        inputSchema: {
+            sql: z
+                .string()
+                .min(1, "SQL query is required")
+                .describe("SQL SELECT statement to execute"),
+            params: z
+                .record(z.unknown())
+                .optional()
+                .describe("Optional named parameters for the query"),
+        },
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    }, async ({ sql, params }) => {
+        try {
+            const result = sqliteManager.query(sql, params);
+            return {
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+                structuredContent: result,
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return {
+                content: [{ type: "text", text: `Error: ${message}` }],
+                isError: true,
+            };
+        }
+    });
+    // ─── sqlite_execute ────────────────────────────────────────────
+    server.registerTool("sqlite_execute", {
+        title: "Execute SQL Statement",
+        description: `Execute a write SQL statement (INSERT, UPDATE, DELETE, CREATE, DROP, ALTER) on the currently open database.
+
+Args:
+  - sql (string): The SQL statement to execute.
+  - params (object, optional): Named parameters for the statement.
+
+Returns:
+  { "changes": number, "lastInsertRowid": number }
+
+Error Handling:
+  - Throws if no database is open. Use sqlite_open first.
+  - Returns SQL error message if the statement is invalid.`,
+        inputSchema: {
+            sql: z
+                .string()
+                .min(1, "SQL statement is required")
+                .describe("SQL statement to execute (INSERT, UPDATE, DELETE, etc.)"),
+            params: z
+                .record(z.unknown())
+                .optional()
+                .describe("Optional named parameters for the statement"),
+        },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: true,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
+    }, async ({ sql, params }) => {
+        try {
+            const result = sqliteManager.execute(sql, params);
+            return {
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+                structuredContent: result,
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return {
+                content: [{ type: "text", text: `Error: ${message}` }],
+                isError: true,
+            };
+        }
+    });
+    // ─── sqlite_list_tables ────────────────────────────────────────
+    server.registerTool("sqlite_list_tables", {
+        title: "List SQLite Tables",
+        description: `List all user tables in the currently open SQLite database.
+
+Returns:
+  { "tables": string[] }
+
+Error Handling:
+  - Throws if no database is open. Use sqlite_open first.`,
+        inputSchema: {},
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    }, async () => {
+        try {
+            const result = sqliteManager.listTables();
+            return {
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+                structuredContent: result,
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return {
+                content: [{ type: "text", text: `Error: ${message}` }],
+                isError: true,
+            };
+        }
+    });
+    // ─── sqlite_describe_table ─────────────────────────────────────
+    server.registerTool("sqlite_describe_table", {
+        title: "Describe SQLite Table",
+        description: `Describe the schema of a specific table in the currently open SQLite database.
+
+Args:
+  - table_name (string): Name of the table to describe.
+
+Returns:
+  {
+    "name": string,
+    "columns": [
+      { "cid": number, "name": string, "type": string, "notnull": boolean, "defaultValue": unknown, "pk": boolean }
+    ],
+    "rowCount": number
+  }
+
+Error Handling:
+  - Throws if no database is open. Use sqlite_open first.
+  - Returns error if the table does not exist.`,
+        inputSchema: {
+            table_name: z
+                .string()
+                .min(1, "Table name is required")
+                .describe("Name of the table to describe"),
+        },
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    }, async ({ table_name }) => {
+        try {
+            const result = sqliteManager.describeTable(table_name);
+            return {
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+                structuredContent: result,
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return {
+                content: [{ type: "text", text: `Error: ${message}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=sqlite.js.map

package/dist/tools/sqlite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite.js","sourceRoot":"","sources":["../../src/tools/sqlite.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,52 @@
+{
+    "name": "easy-sqlite-mcp",
+    "version": "1.0.1",
+    "description": "A high-performance Model Context Protocol (MCP) server for SQLite database interaction.",
+    "keywords": [
+        "mcp",
+        "mcp-server",
+        "sqlite",
+        "database",
+        "better-sqlite3"
+    ],
+    "author": "chenkumi",
+    "license": "MIT",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/chenkumi/easy-sqlite-mcp.git"
+    },
+    "bugs": {
+        "url": "https://github.com/chenkumi/easy-sqlite-mcp/issues"
+    },
+    "homepage": "https://github.com/chenkumi/easy-sqlite-mcp#readme",
+    "files": [
+        "dist",
+        "skills",
+        "README.md"
+    ],
+    "type": "module",
+    "main": "dist/index.js",
+    "bin": {
+        "easy-sqlite-mcp": "dist/index.js"
+    },
+    "scripts": {
+        "start": "node dist/index.js",
+        "dev": "tsx watch src/index.ts",
+        "build": "tsc",
+        "clean": "rimraf dist"
+    },
+    "engines": {
+        "node": ">=18"
+    },
+    "dependencies": {
+        "@modelcontextprotocol/sdk": "^1.6.1",
+        "better-sqlite3": "^11.7.0",
+        "zod": "^3.23.8"
+    },
+    "devDependencies": {
+        "@types/better-sqlite3": "^7.6.12",
+        "@types/node": "^22.10.0",
+        "tsx": "^4.19.2",
+        "typescript": "^5.7.2"
+    }
+}

package/skills/sqlite-mcp/SKILL.md

@@ -0,0 +1,37 @@
+---
+name: sqlite-mcp
+description: A skill specialized in operating SQLite databases. Use this skill when users mention "query database", "read .db or .sqlite files", "store structured data in SQLite", or need to perform SQL operations. This skill provides functionality to open/close databases, execute SQL queries (SELECT), perform write operations (INSERT/UPDATE/DELETE), and explore table schemas.
+---
+
+# SQLite MCP Skill
+
+This skill allows you to interact with SQLite databases through a series of MCP tools.
+
+## Core Workflow
+
+### 1. Open Database
+Before any operation, you must use `sqlite_open` to open the database file.
+- **Tool**: `sqlite_open`
+- **Parameters**: `file_path` (Absolute or relative path)
+
+### 2. Explore Structure (Optional)
+If the database content is unclear, you can list tables or view table definitions first.
+- **List Tables**: `sqlite_list_tables`
+- **View Structure**: `sqlite_describe_table` (requires `table_name`)
+
+### 3. Data Operation
+- **Read Data**: Use `sqlite_query` to execute `SELECT` statements.
+- **Write Data**: Use `sqlite_execute` to execute `INSERT`, `UPDATE`, `DELETE`, or DDL statements (e.g., `CREATE TABLE`).
+- **Parameterized Queries**: It is recommended to use the `params` parameter (e.g., `{ ":id": 1 }`) to prevent SQL injection.
+
+### 4. Check Status
+You can use `sqlite_status` at any time to confirm the current database path and connection status.
+
+### 5. Close Database
+After work is finished, use `sqlite_close` to release resources.
+
+## Best Practices
+- **Security First**: Prioritize parameterized queries over direct SQL string concatenation.
+- **Transaction Management**: Ensure logical consistency for multi-step write operations.
+- **Path Handling**: Ensure correct path formatting (supports `/` or `\\`).
+- **Error Handling**: If an operation fails, check `sqlite_status` to ensure the database is correctly opened.