sqlite

Local 2025-08-31 23:24:01 0

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.

Overview

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"
    ]
  }
}

Building

Docker:

docker build -t mcp/sqlite .

License

This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.

[
  {
    "description": "Execute a SELECT query on the SQLite database",
    "inputSchema": {
      "properties": {
        "query": {
          "description": "SELECT SQL query to execute",
          "type": "string"
        }
      },
      "required": [
        "query"
      ],
      "type": "object"
    },
    "name": "read_query"
  },
  {
    "description": "Execute an INSERT, UPDATE, or DELETE query on the SQLite database",
    "inputSchema": {
      "properties": {
        "query": {
          "description": "SQL query to execute",
          "type": "string"
        }
      },
      "required": [
        "query"
      ],
      "type": "object"
    },
    "name": "write_query"
  },
  {
    "description": "Create a new table in the SQLite database",
    "inputSchema": {
      "properties": {
        "query": {
          "description": "CREATE TABLE SQL statement",
          "type": "string"
        }
      },
      "required": [
        "query"
      ],
      "type": "object"
    },
    "name": "create_table"
  },
  {
    "description": "List all tables in the SQLite database",
    "inputSchema": {
      "properties": {},
      "type": "object"
    },
    "name": "list_tables"
  },
  {
    "description": "Get the schema information for a specific table",
    "inputSchema": {
      "properties": {
        "table_name": {
          "description": "Name of the table to describe",
          "type": "string"
        }
      },
      "required": [
        "table_name"
      ],
      "type": "object"
    },
    "name": "describe_table"
  },
  {
    "description": "Add a business insight to the memo",
    "inputSchema": {
      "properties": {
        "insight": {
          "description": "Business insight discovered from data analysis",
          "type": "string"
        }
      },
      "required": [
        "insight"
      ],
      "type": "object"
    },
    "name": "append_insight"
  }
]