Database Analytics MCP Server

A practical database analytics MCP server built with FastMCP, providing SQLite database operations through the Model Context Protocol (MCP). Perfect for data analysis workflows with AI assistants like Claude.

What This Server Provides

🛠️ Tools (Interactive Operations)

• connect_db - Connect to SQLite database files
• execute_query - Execute SQL queries with safety checks
• list_tables - List all tables in the database

📊 Resources (Read-only Data Access)

• schema://tables/{table_name} - Get table column information and structure
• data://tables/{table_name} - Get sample table data for preview

🔐 Safety Features

• SQL injection prevention with dangerous operation blocking
• Read-only resource access for safe schema exploration
• Comprehensive error handling with descriptive messages

Setup and Installation

1. Clone the repository:

   hljs language-bash

   Copy

   git clone https://github.com/khuyentran1401/database-analytics-mcp.git
   cd database-analytics-mcp
   

2. Install UV (recommended):

   hljs language-bash

   Copy

   # Install UV if you haven't already
   curl -LsSf https://astral.sh/uv/install.sh | sh
   

3. Install dependencies:

   hljs language-bash

   Copy

   # UV automatically manages dependencies from pyproject.toml
   uv sync
   

4. Test the server:

   hljs language-bash

   Copy

   uv run example_usage.py
   

5. Add to Claude Code

   hljs language-bash

   Copy

   # Quick setup
   claude mcp add database-analytics -- uv run database_mcp_server.py
   

   Verify installation:

   hljs language-bash

   Copy

   # Check if the server is registered
   claude mcp list
   

Other MCP Clients

For any MCP client that supports the standard protocol:

servers:
  - name: database-analytics
    transport:
      type: stdio
      command: uv
      args: ["run", "database_mcp_server.py"]

Example Workflows

Data Exploration with Claude Code

1. Connect to Database

   hljs language-text

   Copy

   Connect to my SQLite database at ./sample_database.db
   

2. Explore Schema

   hljs language-text

   Copy

   What tables are available in this database?
   

3. Examine Table Structure

   hljs language-text

   Copy

   Show me the schema for the users table
   

4. Preview Data

   hljs language-text

   Copy

   Show me some sample data from the users table
   

5. Run Analytics Queries

   hljs language-text

   Copy

   Calculate total sales by product category
   

6. Export Results

   hljs language-text

   Copy

   Export the query "SELECT product_name, SUM(quantity) as total_sold FROM orders GROUP BY product_name" to CSV file called sales_report.csv
   

7. Get Table Statistics

   hljs language-text

   Copy

   Show me statistics for the users table
   

Common Use Cases

• Database Schema Discovery: Quickly understand database structure
• Data Quality Checks: Sample data to verify data integrity
• Ad-hoc Analysis: Run custom SQL queries safely
• Report Generation: Execute complex analytical queries
• Data Exploration: Browse tables and relationships with pagination
• Data Export: Export query results to CSV for external analysis
• Performance Monitoring: Track query execution times

Available Tools & Resources

Tools (Interactive Operations)

Resources (Read-only Access)