Cursor DB Explorer

by jbdamask

11 stars

Not rated

GitHub

About

Provides access to Cursor IDE's SQLite databases for exploring project data, chat history, and composer information through an API that automatically detects installations and exposes structured resources and tools for analysis.

Details

Author: jbdamask
Repository: jbdamask/cursor-db-mcp
GitHub stars: 11
License: Other
Categories: Community, Developer Tools, AI, Project Management, Infrastructure, API, Knowledge Base

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below
Plugin Name Cursor DB Explorer

Command (node, npx, python, etc.) /Users/johndamask/.local/bin/uv
Arguments
- Argument 1 run
- Argument 2 --with
- Argument 3 mcp[cli]
- Argument 4 mcp
- Argument 5 run
- Argument 6 /Users/johndamask/code/cursor-db-mcp/cursor-db-mcp-server.py
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "cursor db explorer": {
            "cwd": null,
            "env": {},
            "args": [
                "run",
                "--with",
                "mcp[cli]",
                "mcp",
                "run",
                "/Users/johndamask/code/cursor-db-mcp/cursor-db-mcp-server.py"
            ],
            "shell": false,
            "command": "/Users/johndamask/.local/bin/uv"
        }
    }
}

JSON

{
    "mcpServers": {
        "cursor db explorer": {
            "cwd": null,
            "env": {},
            "args": [
                "run",
                "--with",
                "mcp[cli]",
                "mcp",
                "run",
                "<fully qualified path to >/cursor-db-mcp-server.py"
            ],
            "shell": false,
            "command": "<fully qualified path to >/uv"
        }
    }
}

JSON

{
    "mcpServers": {
        "cursor db explorer": {
            "cwd": null,
            "env": {},
            "args": [
                "run",
                "--with",
                "mcp[cli]",
                "mcp",
                "run",
                "<fully qualified path to >/cursor-db-mcp-server.py"
            ],
            "shell": false,
            "command": "<fully qualified path to >/uv"
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "cursor db explorer": {
            "cwd": null,
            "env": {},
            "args": [
                "run",
                "--with",
                "mcp[cli]",
                "mcp",
                "run",
                "/Users/johndamask/code/cursor-db-mcp/cursor-db-mcp-server.py"
            ],
            "shell": false,
            "command": "/Users/johndamask/.local/bin/uv"
        }
    }
}

JSON

{
    "mcpServers": {
        "cursor db explorer": {
            "cwd": null,
            "env": {},
            "args": [
                "run",
                "--with",
                "mcp[cli]",
                "mcp",
                "run",
                "<fully qualified path to >/cursor-db-mcp-server.py"
            ],
            "shell": false,
            "command": "<fully qualified path to >/uv"
        }
    }
}

JSON

{
    "mcpServers": {
        "cursor db explorer": {
            "cwd": null,
            "env": {},
            "args": [
                "run",
                "--with",
                "mcp[cli]",
                "mcp",
                "run",
                "<fully qualified path to >/cursor-db-mcp-server.py"
            ],
            "shell": false,
            "command": "<fully qualified path to >/uv"
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "cursor db explorer": {
            "cwd": null,
            "env": {},
            "args": [
                "run",
                "--with",
                "mcp[cli]",
                "mcp",
                "run",
                "/Users/johndamask/code/cursor-db-mcp/cursor-db-mcp-server.py"
            ],
            "shell": false,
            "command": "/Users/johndamask/.local/bin/uv"
        }
    }
}

JSON

{
    "mcpServers": {
        "cursor db explorer": {
            "cwd": null,
            "env": {},
            "args": [
                "run",
                "--with",
                "mcp[cli]",
                "mcp",
                "run",
                "<fully qualified path to >/cursor-db-mcp-server.py"
            ],
            "shell": false,
            "command": "<fully qualified path to >/uv"
        }
    }
}

JSON

{
    "mcpServers": {
        "cursor db explorer": {
            "cwd": null,
            "env": {},
            "args": [
                "run",
                "--with",
                "mcp[cli]",
                "mcp",
                "run",
                "<fully qualified path to >/cursor-db-mcp-server.py"
            ],
            "shell": false,
            "command": "<fully qualified path to >/uv"
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "cursor db explorer": {
            "cwd": null,
            "env": {},
            "args": [
                "run",
                "--with",
                "mcp[cli]",
                "mcp",
                "run",
                "/Users/johndamask/code/cursor-db-mcp/cursor-db-mcp-server.py"
            ],
            "shell": false,
            "command": "/Users/johndamask/.local/bin/uv"
        }
    }
}

JSON

{
    "mcpServers": {
        "cursor db explorer": {
            "cwd": null,
            "env": {},
            "args": [
                "run",
                "--with",
                "mcp[cli]",
                "mcp",
                "run",
                "<fully qualified path to >/cursor-db-mcp-server.py"
            ],
            "shell": false,
            "command": "<fully qualified path to >/uv"
        }
    }
}

JSON

{
    "mcpServers": {
        "cursor db explorer": {
            "cwd": null,
            "env": {},
            "args": [
                "run",
                "--with",
                "mcp[cli]",
                "mcp",
                "run",
                "<fully qualified path to >/cursor-db-mcp-server.py"
            ],
            "shell": false,
            "command": "<fully qualified path to >/uv"
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "cursor db explorer": {
            "cwd": null,
            "env": {},
            "args": [
                "run",
                "--with",
                "mcp[cli]",
                "mcp",
                "run",
                "/Users/johndamask/code/cursor-db-mcp/cursor-db-mcp-server.py"
            ],
            "shell": false,
            "command": "/Users/johndamask/.local/bin/uv"
        }
    }
}

JSON

{
    "mcpServers": {
        "cursor db explorer": {
            "cwd": null,
            "env": {},
            "args": [
                "run",
                "--with",
                "mcp[cli]",
                "mcp",
                "run",
                "<fully qualified path to >/cursor-db-mcp-server.py"
            ],
            "shell": false,
            "command": "<fully qualified path to >/uv"
        }
    }
}

JSON

{
    "mcpServers": {
        "cursor db explorer": {
            "cwd": null,
            "env": {},
            "args": [
                "run",
                "--with",
                "mcp[cli]",
                "mcp",
                "run",
                "<fully qualified path to >/cursor-db-mcp-server.py"
            ],
            "shell": false,
            "command": "<fully qualified path to >/uv"
        }
    }
}

From the repository

Use the provided installation script to install all dependencies:

python install.py

This script will install:
- Basic MCP server and dependencies

<!-- ### Manual Installation

1. Clone this repository:

git clone https://github.com/yourusername/cursor-db-mcp.git

cd cursor-db-mcp

2. Install basic dependencies:

pip install -r requirements.txt

3. Install MCP CLI tools (optional, for testing):

pip install 'mcp[cli]'  # Note the quotes around mcp[cli]

If the above command fails, you can install the CLI dependencies directly:

pip install typer rich

-->

<!-- ## Usage

`query_table`

Query a specific table in a project's database.

`refresh_databases`

Refresh the list of database paths.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "cursor db explorer": {
            "cwd": null,
            "env": {},
            "args": [
                "run",
                "--with",
                "mcp[cli]",
                "mcp",
                "run",
                "/Users/johndamask/code/cursor-db-mcp/cursor-db-mcp-server.py"
            ],
            "shell": false,
            "command": "/Users/johndamask/.local/bin/uv"
        }
    }
}

Linux

{
    "cwd": null,
    "env": [],
    "args": [
        "run",
        "--with",
        "mcp[cli]",
        "mcp",
        "run",
        "<fully qualified path to >/cursor-db-mcp-server.py"
    ],
    "shell": false,
    "command": "<fully qualified path to >/uv"
}

Macos

{
    "cwd": null,
    "env": [],
    "args": [
        "run",
        "--with",
        "mcp[cli]",
        "mcp",
        "run",
        "/Users/johndamask/code/cursor-db-mcp/cursor-db-mcp-server.py"
    ],
    "shell": false,
    "command": "/Users/johndamask/.local/bin/uv"
}

Windows

{
    "cwd": null,
    "env": [],
    "args": [
        "run",
        "--with",
        "mcp[cli]",
        "mcp",
        "run",
        "<fully qualified path to >/cursor-db-mcp-server.py"
    ],
    "shell": false,
    "command": "<fully qualified path to >/uv"
}

Cursor DB MCP Server

A Model Context Protocol (MCP) server for accessing Cursor IDE's SQLite databases. This server allows AI assistants to explore and interact with Cursor's project data, chat history, and composer information.

__Cursor__
In Cursor GIF

Prerequisites

Cursor IDE

Installation

Easy Installation

Use the provided installation script to install all dependencies:

python install.py

This script will install:
- Basic MCP server and dependencies

<!-- ### Manual Installation

1. Clone this repository:

git clone https://github.com/yourusername/cursor-db-mcp.git

cd cursor-db-mcp

2. Install basic dependencies:

pip install -r requirements.txt

3. Install MCP CLI tools (optional, for testing):

pip install 'mcp[cli]'  # Note the quotes around mcp[cli]

If the above command fails, you can install the CLI dependencies directly:

pip install typer rich

-->

<!-- ## Usage

Using with Claude Desktop

1. Install the MCP server in Claude Desktop:

mcp install cursor-db-mcp-server.py

2. In Claude Desktop, you can now access your Cursor data by asking questions like:
- "Show me a list of my Cursor projects"
- "What's in my chat history for project X?"
- "Find composer data for composer ID Y"

See detailed examples below

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

query_table

refresh_databases

Claude Desktop / Cursor

Linux

Macos

Windows

Cursor DB MCP Server

Prerequisites

Installation

Easy Installation

Using with Claude Desktop

Install

More like this

Sentry

Github

Git

GitLab

Context 7

1Panel

`query_table`

`refresh_databases`