sqlite

Servidor que permite operar bases de datos SQLite a través de MCP (Model Context Protocol). En el arranque se registran varias bases de datos en formato «alias=ruta», y al invocar las herramientas se selecciona la base de datos por su nombre de alias. Como no acepta rutas de archivo arbitrarias en tiempo de ejecución, es seguro.

Funciones (herramientas)

• list_databases — Muestra la lista de alias de las bases de datos registradas

• list_tables — Muestra la lista de todos los nombres de tablas dentro de la base de datos especificada

• describe_table — Obtiene el esquema de la tabla especificada (columnas/tipos/claves externas/índices)

• read_query — Ejecuta SELECT / WITH / PRAGMA (solo lectura)

• write_query — Ejecuta INSERT / UPDATE / DELETE / DDL (modificación de datos)

list_tables/describe_table/read_query/write_query aceptan un argumento database opcional (nombre de alias). Si solo hay una base de datos registrada, se puede omitir (automáticamente se convierte en la predeterminada). Si hay dos o más registradas, es obligatorio especificar database en cada llamada.

Related MCP server: MCP SQLite Server

Configuración

npm install

Arranque

Se inicia especificando una o más bases de datos en el formato alias=ruta.

node index.js main=/path/to/main.db logs=/path/to/logs.db

Si se registra solo una (en este caso se puede omitir el argumento database):

node index.js main=/path/to/main.db

Variables de entorno

Ejemplos de uso

// 登録済みDB一覧を確認
{ "tool": "list_databases", "arguments": {} }

// "main" DBのテーブル一覧
{ "tool": "list_tables", "arguments": { "database": "main" } }

// "logs" DBに対してクエリ
{ "tool": "read_query", "arguments": { "sql": "SELECT * FROM events", "database": "logs" } }

// DBが1つしか登録されていない場合は database 省略可
{ "tool": "read_query", "arguments": { "sql": "SELECT * FROM users" } }

Registro en el cliente MCP

Claude Desktop

Añada lo siguiente a claude_desktop_config.json (especifique la ruta como ruta absoluta según su entorno):

{
  "mcpServers": {
    "sqlite": {
      "command": "node",
      "args": [
        "/絶対パス/sqlite-mcp-server/index.js",
        "main=/絶対パス/main.db",
        "logs=/絶対パス/logs.db"
      ]
    }
  }
}

Tras la configuración, reinicie Claude Desktop y las herramientas del servidor sqlite estarán disponibles.

Claude Code (CLI / extensión de VS Code)

Regístrelo desde el terminal dentro de VS Code, o desde un terminal normal con el comando claude.

claude mcp add --transport stdio sqlite -- node /絶対パス/sqlite-mcp-server/index.js main=/絶対パス/main.db logs=/絶対パス/logs.db

• Lo que va después de -- se pasa directamente como comando de arranque del servidor.

• Si desea modo solo lectura, añada --env SQLITE_READONLY=1:

  claude mcp add --transport stdio --env SQLITE_READONLY=1 sqlite -- node /絶対パス/index.js main=/絶対パス/main.db

• El valor predeterminado es el ámbito local (solo su proyecto actual). Para usarlo en todos los proyectos añada --scope user; para compartirlo con el equipo como .mcp.json, añada --scope project.

  claude mcp add --transport stdio --scope user sqlite -- node /絶対パス/index.js main=/絶対パス/main.db

Para comprobar o eliminar el registro:

claude mcp list
claude mcp remove sqlite

Al abrir el panel de Claude Code en VS Code (o iniciar una sesión de claude), estarán disponibles herramientas como list_databases o read_query.

Notas

• En write_query se recomienda usar el marcador de posición ? como medida contra la inyección SQL (argumento params).

• Los nombres de tabla se validan para permitir únicamente caracteres alfanuméricos y guiones bajos.

• Los nombres de alias solo pueden contener caracteres alfanuméricos, guiones bajos y guiones.

• La conexión a cada base de datos se abre en el primer acceso y se reutiliza a partir de entonces. Todas se cierran al finalizar el servidor.

• No se puede acceder a ninguna base de datos que no sea la registrada en el arranque (no se aceptan rutas arbitrarias).

• Si va a conectarse a una base de datos de producción, considere iniciar con SQLITE_READONLY=1.