database-mcp-libsql

Name: database-mcp-libsql
Author: arifulislamat

arifulislamat

MCP servers for SQL databases. One package per engine (SQLite, libSQL, MySQL, MariaDB, Postgres), two tools, read-only by default, secrets never in logs.

Setup

Choose your client, copy the config, then fill in any required environment variables.

Add to Cursor Add to VS Code

claude mcp add database-libsql --env LIBSQL_URL='<LIBSQL_URL>' --env LIBSQL_AUTH_TOKEN='<LIBSQL_AUTH_TOKEN>' --env MARIADB_HOST='<MARIADB_HOST>' --env MARIADB_USER='<MARIADB_USER>' --env MARIADB_PASSWORD='<MARIADB_PASSWORD>' --env MARIADB_DATABASE='<MARIADB_DATABASE>' --env MYSQL_HOST='<MYSQL_HOST>' --env MYSQL_USER='<MYSQL_USER>' --env MYSQL_PASSWORD='<MYSQL_PASSWORD>' --env MYSQL_DATABASE='<MYSQL_DATABASE>' -- npx -y @database-mcp/libsql

~/.codex/config.toml

[mcp_servers.database-libsql]
command = "npx"
args = ["-y", "@database-mcp/libsql"]
env = { LIBSQL_URL = "<LIBSQL_URL>", LIBSQL_AUTH_TOKEN = "<LIBSQL_AUTH_TOKEN>", MARIADB_HOST = "<MARIADB_HOST>", MARIADB_USER = "<MARIADB_USER>", MARIADB_PASSWORD = "<MARIADB_PASSWORD>", MARIADB_DATABASE = "<MARIADB_DATABASE>", MYSQL_HOST = "<MYSQL_HOST>", MYSQL_USER = "<MYSQL_USER>", MYSQL_PASSWORD = "<MYSQL_PASSWORD>", MYSQL_DATABASE = "<MYSQL_DATABASE>" }

# codex mcp add database-libsql --env LIBSQL_URL='<LIBSQL_URL>' --env LIBSQL_AUTH_TOKEN='<LIBSQL_AUTH_TOKEN>' --env MARIADB_HOST='<MARIADB_HOST>' --env MARIADB_USER='<MARIADB_USER>' --env MARIADB_PASSWORD='<MARIADB_PASSWORD>' --env MARIADB_DATABASE='<MARIADB_DATABASE>' --env MYSQL_HOST='<MYSQL_HOST>' --env MYSQL_USER='<MYSQL_USER>' --env MYSQL_PASSWORD='<MYSQL_PASSWORD>' --env MYSQL_DATABASE='<MYSQL_DATABASE>' -- npx -y @database-mcp/libsql

~/.cursor/mcp.json

{
  "mcpServers": {
    "database-libsql": {
      "command": "npx",
      "args": [
        "-y",
        "@database-mcp/libsql"
      ],
      "env": {
        "LIBSQL_URL": "<LIBSQL_URL>",
        "LIBSQL_AUTH_TOKEN": "<LIBSQL_AUTH_TOKEN>",
        "MARIADB_HOST": "<MARIADB_HOST>",
        "MARIADB_USER": "<MARIADB_USER>",
        "MARIADB_PASSWORD": "<MARIADB_PASSWORD>",
        "MARIADB_DATABASE": "<MARIADB_DATABASE>",
        "MYSQL_HOST": "<MYSQL_HOST>",
        "MYSQL_USER": "<MYSQL_USER>",
        "MYSQL_PASSWORD": "<MYSQL_PASSWORD>",
        "MYSQL_DATABASE": "<MYSQL_DATABASE>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "database-libsql": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@database-mcp/libsql"
      ],
      "env": {
        "LIBSQL_URL": "<LIBSQL_URL>",
        "LIBSQL_AUTH_TOKEN": "<LIBSQL_AUTH_TOKEN>",
        "MARIADB_HOST": "<MARIADB_HOST>",
        "MARIADB_USER": "<MARIADB_USER>",
        "MARIADB_PASSWORD": "<MARIADB_PASSWORD>",
        "MARIADB_DATABASE": "<MARIADB_DATABASE>",
        "MYSQL_HOST": "<MYSQL_HOST>",
        "MYSQL_USER": "<MYSQL_USER>",
        "MYSQL_PASSWORD": "<MYSQL_PASSWORD>",
        "MYSQL_DATABASE": "<MYSQL_DATABASE>"
      }
    }
  }
}

~/.gemini/settings.json

{
  "mcpServers": {
    "database-libsql": {
      "command": "npx",
      "args": [
        "-y",
        "@database-mcp/libsql"
      ],
      "env": {
        "LIBSQL_URL": "<LIBSQL_URL>",
        "LIBSQL_AUTH_TOKEN": "<LIBSQL_AUTH_TOKEN>",
        "MARIADB_HOST": "<MARIADB_HOST>",
        "MARIADB_USER": "<MARIADB_USER>",
        "MARIADB_PASSWORD": "<MARIADB_PASSWORD>",
        "MARIADB_DATABASE": "<MARIADB_DATABASE>",
        "MYSQL_HOST": "<MYSQL_HOST>",
        "MYSQL_USER": "<MYSQL_USER>",
        "MYSQL_PASSWORD": "<MYSQL_PASSWORD>",
        "MYSQL_DATABASE": "<MYSQL_DATABASE>"
      }
    }
  }
}

claude_desktop_config.json

{
  "mcpServers": {
    "database-libsql": {
      "command": "npx",
      "args": [
        "-y",
        "@database-mcp/libsql"
      ],
      "env": {
        "LIBSQL_URL": "<LIBSQL_URL>",
        "LIBSQL_AUTH_TOKEN": "<LIBSQL_AUTH_TOKEN>",
        "MARIADB_HOST": "<MARIADB_HOST>",
        "MARIADB_USER": "<MARIADB_USER>",
        "MARIADB_PASSWORD": "<MARIADB_PASSWORD>",
        "MARIADB_DATABASE": "<MARIADB_DATABASE>",
        "MYSQL_HOST": "<MYSQL_HOST>",
        "MYSQL_USER": "<MYSQL_USER>",
        "MYSQL_PASSWORD": "<MYSQL_PASSWORD>",
        "MYSQL_DATABASE": "<MYSQL_DATABASE>"
      }
    }
  }
}

.trae/mcp.json

{
  "mcpServers": {
    "database-libsql": {
      "command": "npx",
      "args": [
        "-y",
        "@database-mcp/libsql"
      ],
      "env": {
        "LIBSQL_URL": "<LIBSQL_URL>",
        "LIBSQL_AUTH_TOKEN": "<LIBSQL_AUTH_TOKEN>",
        "MARIADB_HOST": "<MARIADB_HOST>",
        "MARIADB_USER": "<MARIADB_USER>",
        "MARIADB_PASSWORD": "<MARIADB_PASSWORD>",
        "MARIADB_DATABASE": "<MARIADB_DATABASE>",
        "MYSQL_HOST": "<MYSQL_HOST>",
        "MYSQL_USER": "<MYSQL_USER>",
        "MYSQL_PASSWORD": "<MYSQL_PASSWORD>",
        "MYSQL_DATABASE": "<MYSQL_DATABASE>"
      }
    }
  }
}

Environment variables

LIBSQL_URL
LIBSQL_AUTH_TOKEN
MARIADB_HOST
MARIADB_USER
MARIADB_PASSWORD
MARIADB_DATABASE
MYSQL_HOST
MYSQL_USER
MYSQL_PASSWORD
MYSQL_DATABASE

Replace the placeholders with your own credentials and keep them out of version control.

Setup

Environment variables

Related