mcp sqlite bun server

Local 2025-09-01 00:12:19 0

databases @jacksteamdev/mcp-sqlite-bun-server

A Model Context Protocol server that provides database interaction capabilities through SQLite, enabling users to run SQL queries, analyze business data, and automatically generate business insight memos.

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.

Installation

Install Bun if you haven't already
Clone this repository
Install dependencies:
```
bun install
```
Run the setup script to configure the server in Claude Desktop:
```
bun run setup
```

The setup script will automatically add the server configuration to your Claude Desktop config file, located at: - macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

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

Development

Project Structure

src/index.ts: Main server implementation
src/logger.ts: Logging utility
scripts/setup.ts: Claude Desktop configuration script

Logging

The server maintains detailed logs in: - server.log: Located in the project root directory - Logs include timestamps, log levels (DEBUG, INFO, WARN, ERROR, FATAL), and structured metadata

Database

The SQLite database file is created at: - data.sqlite: Located in the project root directory - Created automatically if it does not exist

Available Scripts

bun run setup: Configure the server in Claude Desktop
bun run lint: Run ESLint checks
bun run lint:fix: Fix ESLint issues automatically
bun run inspect: Run the MCP inspector

License

This MCP server is licensed under the MIT License. See the LICENSE file for details.

[
  {
    "description": "Execute a read-only SQL query",
    "inputSchema": {
      "properties": {
        "query": {
          "description": "a SELECT query",
          "pattern": "^SELECT",
          "type": "string"
        }
      },
      "required": [
        "query"
      ],
      "type": "object"
    },
    "name": "read-query"
  },
  {
    "description": "Execute a write SQL query",
    "inputSchema": {
      "properties": {
        "query": {
          "description": "an INSERT, UPDATE, or DELETE query",
          "pattern": "^(INSERT|UPDATE|DELETE)",
          "type": "string"
        }
      },
      "required": [
        "query"
      ],
      "type": "object"
    },
    "name": "write-query"
  },
  {
    "description": "Create a new table in the database",
    "inputSchema": {
      "properties": {
        "query": {
          "description": "a CREATE TABLE statement",
          "pattern": "^CREATE TABLE",
          "type": "string"
        }
      },
      "required": [
        "query"
      ],
      "type": "object"
    },
    "name": "create-table"
  },
  {
    "description": "List all tables in the database",
    "inputSchema": {
      "type": "object"
    },
    "name": "list-tables"
  },
  {
    "description": "Get schema information for a table",
    "inputSchema": {
      "properties": {
        "table_name": {
          "type": "string"
        }
      },
      "required": [
        "table_name"
      ],
      "type": "object"
    },
    "name": "describe-table"
  },
  {
    "description": "Add a business insight to the memo",
    "inputSchema": {
      "properties": {
        "insight": {
          "type": "string"
        }
      },
      "required": [
        "insight"
      ],
      "type": "object"
    },
    "name": "append-insight"
  }
]