Skip to content

StacklokLabs/sqlite-mcp

SQLite MCP Server

A Model Context Protocol (MCP) server that provides tools and resources for querying SQLite databases. This server enables LLMs to interact with SQLite databases through a standardized protocol.

Features

  • Database Query Tools: Execute SELECT queries and data modification statements
  • Schema Resources: Access database schema information and table structures
  • SSE Transport: Server-Sent Events transport for real-time communication
  • Read-Only Mode: Optional read-only mode for safe database access
  • Comprehensive Testing: Full test coverage with testify
  • Linting: Code quality ensured with golangci-lint

Tools

The server provides the following MCP tools:

  • execute_query: Execute SELECT queries against the SQLite database
  • execute_statement: Execute INSERT, UPDATE, or DELETE statements (only in read-write mode)
  • list_tables: List all tables in the database
  • describe_table: Get schema information for a specific table

Resources

The server provides the following MCP resources:

  • schema://tables: List of all tables in the database
  • schema://table/{name}: Schema information for a specific table

Installation

go build -o sqlite-mcp .

Usage

Basic Usage

./sqlite-mcp -db ./path/to/database.db

Command Line Options

./sqlite-mcp [options]

Options:
  -addr string
        Address to listen on (default ":8080")
  -db string
        Path to SQLite database file (default "./database.db")
  -help
        Show help message
  -read-write
        Whether to allow write operations on the database. When false, the server operates in read-only mode

Environment Variables

  • MCP_PORT: Port to listen on (overrides -addr flag port)

Development

Prerequisites

  • Go 1.21 or later
  • SQLite database file

Contributing

  1. Fork the repository
  2. Create a feature branch
  3. Make your changes
  4. Add tests for new functionality
  5. Run tests and linting
  6. Submit a pull request

About

A SQLite MCP server

Resources

License

Code of conduct

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors 3

  •  
  •  
  •  

Languages