MCP SQLite Server

Servidor MCP SQLite

Uma implementação em Node.js do servidor SQLite do Model Context Protocol, baseada na referência oficial em Python. Esta versão oferece uma alternativa baseada em npx para ambientes onde o executor UVX do Python não está disponível, como o LibreChat.

Uso com Claude Desktop

Instalação Manual

Adicione o seguinte ao 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"
      }
    }
  }
}

Exemplo completo ao usar nvm no 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"
      }
    }
  }
}

Exemplo completo ao usar nvm no 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"
      }
    }
  }
}

Instalação via Smithery

Para instalar o MCP SQLite Server para Claude Desktop automaticamente via Smithery:

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

Desenvolvimento

1. Instale as dependências:

npm ci

2. Compile o código TypeScript:

npm run build

Testando com o MCP Inspector

Você pode testar o servidor usando a ferramenta MCP Inspector:

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

Connect e vá para Tools para começar a usar o servidor.

Testando com Claude Desktop

Adicione o seguinte ao claude_desktop_config.json:

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

Exemplos:

• /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

Publicação

• Aumente a versão no package.json
• npm install
• Faça o commit com a mensagem: Release {version, e.g. 0.1.6}