MCP SQLite Server

Un servidor MCP en Node.js para interactuar con bases de datos SQLite locales, ejecutable mediante npx.

Documentación

MCP SQLite Server

smithery badge MseeP.ai Security Assessment Badge

Una implementación en Node.js del servidor SQLite del Model Context Protocol, basada en la referencia oficial de Python. Esta versión proporciona una alternativa basada en npx para entornos donde el ejecutor UVX de Python no está disponible, como LibreChat.

Uso con Claude Desktop

Instalación manual

Agrega lo siguiente a claude_desktop_config.json:

{
  "mcpServers": {
    "sqlite": {
      "command": "/absolute/path/to/npx",
      "args": [
        "-y",
        "mcp-server-sqlite-npx",
        "/absolute/path/to/database.db"
      ],
      "env": {
        "PATH": "/absolute/path/to/executables",
        "NODE_PATH": "/absolute/path/to/node_modules"
      }
    }
  }
}

Ejemplo completo al usar nvm en macOS:

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "sqlite": {
      "command": "/Users/{username}/.nvm/versions/node/v22.12.0/bin/npx",
      "args": [
        "-y",
        "mcp-server-sqlite-npx",
        "/Users/{username}/projects/database.db"
      ],
      "env": {
        "PATH": "/Users/{username}/.nvm/versions/node/v22.12.0/bin:/usr/local/bin:/usr/bin:/bin",
        "NODE_PATH": "/Users/{username}/.nvm/versions/node/v22.12.0/lib/node_modules"
      }
    }
  }
}

Ejemplo completo al usar nvm en Windows:

%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "sqlite": {
      "command": "C:\\Program Files\\nodejs\\npx.cmd",
      "args": [
        "-y",
        "mcp-server-sqlite-npx",
        "C:\\Users\\{username}\\projects\\database.db"
      ],
      "env": {
        "PATH": "C:\\Program Files\\nodejs;%PATH%",
        "NODE_PATH": "C:\\Program Files\\nodejs\\node_modules"
      }
    }
  }
}

Instalación mediante Smithery

Para instalar MCP SQLite Server para Claude Desktop automáticamente mediante Smithery:

npx -y @smithery/cli install mcp-server-sqlite-npx --client claude

Desarrollo

  1. Instala las dependencias:
npm ci
  1. Compila el código TypeScript:
npm run build

Pruebas con MCP Inspector

Puedes probar el servidor usando la herramienta MCP Inspector:

npx @modelcontextprotocol/inspector node dist/index.js /absolute/path/to/database.db

Connect y ve a Tools para comenzar a usar el servidor.

Pruebas con Claude Desktop

Agrega lo siguiente a claude_desktop_config.json:

{
  "mcpServers": {
    "sqlite": {
      "command": "/absolute/path/to/node",
      "args": [
        "/absolute/path/to/dist/index.js",
        "/absolute/path/to/database.db"
      ]
    }
  }
}

Ejemplos:

  • /absolute/path/to/node: /Users/{username}/.nvm/versions/node/v20.18.1/bin/node
  • /absolute/path/to/index.js: /Users/{username}/projects/mcp-server-sqlite-npx/dist/index.js
  • /absolute/path/to/database.db: /Users/{username}/projects/database.db

Publicar

  • Incrementa la versión en package.json
  • npm install
  • Realiza un commit con el mensaje: Release {version, e.g. 0.1.6}