Query and Manipulate SQLite Databases

SQLite MCP Server

Overview

A Model Context Protocol (MCP) server implementation that provides database interaction and business intelligence capabilities through SQLite. This server enables running SQL queries, analyzing business data, and automatically generating business insight memos.

Components

Resources

The server exposes a single dynamic resource:

• memo://insights: A continuously updated business insights memo that aggregates discovered insights during analysis
  • Auto-updates as new insights are discovered via the append-insight tool

Prompts

The server provides a demonstration prompt:

• mcp-demo: Interactive prompt that guides users through database operations
  • Required argument: topic - The business domain to analyze
  • Generates appropriate database schemas and sample data
  • Guides users through analysis and insight generation
  • Integrates with the business insights memo

Tools

The server offers six core tools:

Query Tools

• read_query

  • Execute SELECT queries to read data from the database
  • Input:
    • query (string): The SELECT SQL query to execute
  • Returns: Query results as array of objects

• write_query

  • Execute INSERT, UPDATE, or DELETE queries
  • Input:
    • query (string): The SQL modification query
  • Returns: { affected_rows: number }

• create_table

  • Create new tables in the database
  • Input:
    • query (string): CREATE TABLE SQL statement
  • Returns: Confirmation of table creation

Schema Tools

• list_tables

  • Get a list of all tables in the database
  • No input required
  • Returns: Array of table names

• describe-table

  • View schema information for a specific table
  • Input:
    • table_name (string): Name of table to describe
  • Returns: Array of column definitions with names and types

Analysis Tools

• append_insight
  • Add new business insights to the memo resource
  • Input:
    • insight (string): Business insight discovered from data analysis
  • Returns: Confirmation of insight addition
  • Triggers update of memo://insights resource

Usage with Claude Desktop

uv

# Add the server to your claude_desktop_config.json
"mcpServers": {
  "sqlite": {
    "command": "uv",
    "args": [
      "--directory",
      "parent_of_servers_repo/servers/src/sqlite",
      "run",
      "mcp-server-sqlite",
      "--db-path",
      "~/test.db"
    ]
  }
}

Docker

# Add the server to your claude_desktop_config.json
"mcpServers": {
  "sqlite": {
    "command": "docker",
    "args": [
      "run",
      "--rm",
      "-i",
      "-v",
      "mcp-test:/mcp",
      "mcp/sqlite",
      "--db-path",
      "/mcp/test.db"
    ]
  }
}

Usage with VS Code

For quick installation, click the installation buttons below:

For manual installation, add the following JSON block to your User Settings (JSON) file in VS Code. You can do this by pressing Ctrl + Shift + P and typing Preferences: Open Settings (JSON).

Optionally, you can add it to a file called .vscode/mcp.json in your workspace. This will allow you to share the configuration with others.

Note that the mcp key is needed when using the mcp.json file.

uv

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "db_path",
        "description": "SQLite Database Path",
        "default": "${workspaceFolder}/db.sqlite"
      }
    ],
    "servers": {
      "sqlite": {
        "command": "uvx",
        "args": [
          "mcp-server-sqlite",
          "--db-path",
          "${input:db_path}"
        ]
      }
    }
  }
}

Docker

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "db_path",
        "description": "SQLite Database Path (within container)",
        "default": "/mcp/db.sqlite"
      }
    ],
    "servers": {
      "sqlite": {
        "command": "docker",
        "args": [
          "run",
          "-i",
          "--rm",
          "-v",
          "mcp-sqlite:/mcp",
          "mcp/sqlite",
          "--db-path",
          "${input:db_path}"
        ]
      }
    }
  }
}

Building

Docker:

docker build -t mcp/sqlite .

Test with MCP inspector

uv add "mcp[cli]"
mcp dev src/mcp_server_sqlite/server.py:wrapper