SQLite MCP: primeiro sondar uma base de teste só de leitura e depois decidir se escreve

Para quem serve

Para quem quer correr SQL num ficheiro SQLite local, ver dados de negócio e deixar um insight memo. A evidência afirma: este MCP oferece interação com a base e inteligência de negócio via SQLite; pode executar SQL, analisar dados de negócio e gerar automaticamente memos de insight.

Tem de fornecer o ficheiro SQLite apontado por --db-path e aceitar que o processo o lê e até o altera. O exemplo oficial é ~/test.db. Não use uma base de produção na primeira tentativa.

A página está em servers-archived. A evidência não escreve à parte o estado de manutenção nem uma lista de clientes; só cobre: consegue executar mcp-server-sqlite com uv nesse diretório.

Concluir a primeira tentativa em 3 minutos

Siga o caminho principal uv; não tome o Docker como instalação principal. No cliente configure:

"command": "uv",
"args": [
  "--directory",
  "parent_of_servers_repo/servers/src/sqlite",
  "run",
  "mcp-server-sqlite",
  "--db-path",
  "~/test.db"
]

Substitua --directory por um caminho local real e --db-path por uma base de teste descartável.

Pré-condições: uv está instalado; tem direito a criar ou abrir a base de teste. Isto acede a ficheiros locais; não é uma sandbox sem leituras locais.

Onde configurar: command / args MCP do cliente.

Primeira chamada de baixo risco: primeiro sonde sem alterar tabelas—use «executar consultas SQL / analisar dados de negócio» do enunciado de identidade para ver o que já existe, ou leia só o recurso memo://insights. A evidência indica seis ferramentas centrais, mas esse locator não lista nomes nem parâmetros só de leitura. Não chame primeiro o write_query plenamente expandido: executa INSERT, UPDATE ou DELETE e devolve { affected_rows: number }. Também não execute primeiro append-insight; altera o memo.

Sinal de sucesso: depois de o servidor arrancar, obtém um resultado de consulta na base de teste ou lê o conteúdo atual de memo://insights. Se o processo não arrancar, verifique primeiro uv e o diretório; não mude para Docker.

Casos de uso

Caso 1: Ver uma vez os dados de negócio na base de teste. Execute uma consulta ou análise SQL segundo a evidência de identidade. As assinaturas só de leitura das seis ferramentas não estão expandidas no locator; fique em «consegue consultar/analisar a base apontada por --db-path» e não invente nomes de ferramentas nem parâmetros de filtro.

Caso 2: Ler o insight memo e decidir se acrescenta. O recurso memo://insights agrega de forma contínua os insights encontrados na análise e atualiza-se automaticamente quando corre append-insight. Leia primeiro esse recurso. Acrescentar altera o memo; a evidência não tem undo nem escreve parâmetros. Só chame depois de aceitar a reescrita e passar um ponto de confirmação. write_query altera dados de tabela—um efeito secundário diferente do memo; não o use neste caso.

Limites de uso

O caminho principal é uv run mcp-server-sqlite --db-path <file>. O exemplo Docker é docker run --rm -i -v mcp-test:/mcp mcp/sqlite --db-path /mcp/test.db; não o tome como caminho principal. write_query altera linhas sem anulação oficial. append-insight atualiza memo://insights. Exceto write_query e append-insight, a maioria dos nomes e parâmetros das seis ferramentas não está expandida no locator. O acesso a ficheiros locais e escrever a base não são risco zero. A evidência não escreve cópias de segurança, rollback de transação nem um substituto após o arquivo.