iflow-mcp_jbdamask_cursor-db-mcp 0.1.0__tar.gz

iflow_mcp_jbdamask_cursor_db_mcp-0.1.0/LICENSE

@@ -0,0 +1,9 @@
+# Released under MIT License
+
+Copyright (c) 2025 John Damask.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

iflow_mcp_jbdamask_cursor_db_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,267 @@
+Metadata-Version: 2.4
+Name: iflow-mcp_jbdamask_cursor-db-mcp
+Version: 0.1.0
+Summary: A Model Context Protocol (MCP) server for accessing Cursor IDE's SQLite databases
+Author-email: jbdamask <jbdamask@example.com>
+License: MIT
+Project-URL: Homepage, https://github.com/jbdamask/cursor-db-mcp
+Project-URL: Repository, https://github.com/jbdamask/cursor-db-mcp
+Project-URL: Issues, https://github.com/jbdamask/cursor-db-mcp/issues
+Keywords: mcp,cursor,sqlite,database,ide
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: mcp>=1.0.0
+Requires-Dist: pathlib>=1.0.1
+Requires-Dist: typing>=3.7.4.3
+Provides-Extra: cli
+Requires-Dist: mcp[cli]; extra == "cli"
+Requires-Dist: typer>=0.9.0; extra == "cli"
+Requires-Dist: rich>=13.0.0; extra == "cli"
+Dynamic: license-file
+
+# 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.
+
+<!-- __Claude__
+![In Claude GIF](./img/cursor-db-mcp-claude.gif) -->
+
+__Cursor__
+![In Cursor GIF](./img/cursor-db-mcp-in-cursor.gif)
+
+
+## Prerequisites
+
+Cursor IDE
+<!-- Claude Desktop (if you want to use MCP in Claude) -->
+
+## Installation
+
+### Easy Installation
+
+Use the provided installation script to install all dependencies:
+
+```bash
+python install.py
+```
+
+This script will install:
+- Basic MCP server and dependencies
+
+<!-- ### Manual Installation
+
+1. Clone this repository:
+```bash
+git clone https://github.com/yourusername/cursor-db-mcp.git
+cd cursor-db-mcp
+```
+
+2. Install basic dependencies:
+```bash
+pip install -r requirements.txt
+```
+
+3. Install MCP CLI tools (optional, for testing):
+```bash
+pip install 'mcp[cli]'  # Note the quotes around mcp[cli]
+```
+
+If the above command fails, you can install the CLI dependencies directly:
+```bash
+pip install typer rich
+``` -->
+
+<!-- ## Usage
+
+### Using with Claude Desktop
+
+1. Install the MCP server in Claude Desktop:
+```bash
+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
+
+Note: If Claude shows an error connecting to this MCP it's likely because it can't find uv. To fix this, change the command value to include the fully qualified path to uv. For example:
+```
+    "Cursor DB Manager": {
+      "command": "/Users/johndamask/.local/bin/uv",
+      "args": [
+        "run",
+        "--with",
+        "mcp[cli]",
+        "mcp",
+        "run",
+        "/Users/johndamask/code/cursor-db-mcp/cursor-db-mcp-server.py"
+      ]
+    }
+``` -->
+
+## Using with Cursor IDE
+
+1. Open Cursor and navigate to Settings->Cursor Settings->MCP. 
+2. Click: Add new MCP server
+3. Name: Cursor DB MCP; Type: Command
+4. Command: \<fully qualified path to\>uv run --with mcp[cli] mcp run \<fully qualified path to\>/cursor-db-mcp-server.py 
+
+![Cursor DB MCP](./img/cursor-db-mcp.png)
+
+Now you can ask questions about the database or retrieve info about historical chats.
+
+![DB structure](./img/cursor-db-structure.png)
+
+![DB keys](./img/cursor-db-keys.png)
+
+### Using with Claude Desktop 
+
+[Installing MCP servers for Claude Desktop](https://modelcontextprotocol.io/quickstart/user)
+
+Add this to your claude_desktop_config.json file
+```
+    "cursor-db-mcp": {
+      "command": "<fully qualified path to >/uv",
+      "args": [
+        "run",
+        "--with",
+        "mcp[cli]",
+        "mcp",
+        "run",
+        "<fully qualified path to >/cursor-db-mcp-server.py"
+      ]
+    }
+```
+
+
+![Cursor DB fuzzy search](./img/mcp-cursor-db-search.png)
+
+## Available Resources
+
+- `cursor://projects` - List all available Cursor projects
+- `cursor://projects/detailed` - List projects with detailed information
+- `cursor://projects/{project_name}/chat` - Get chat data for a specific project
+- `cursor://projects/{project_name}/composers` - Get composer IDs for a specific project
+- `cursor://composers/{composer_id}` - Get data for a specific composer
+
+## Available Tools
+
+- `query_table` - Query a specific table in a project's database
+- `refresh_databases` - Refresh the list of database paths
+
+
+<!-- # Example Usage with Claude
+
+## Listing Projects
+
+**User**: "Can you show me a list of my Cursor projects?"
+
+**Claude**: 
+```
+I'll retrieve a list of your Cursor projects.
+
+Here are the Cursor projects I found:
+- project1 (path: /Users/username/Library/Application Support/Cursor/User/workspaceStorage/abc123/state.vscdb)
+- project2 (path: /Users/username/Library/Application Support/Cursor/User/workspaceStorage/def456/state.vscdb)
+- custom-project (path: /Users/username/code/custom-project/state.vscdb)
+```
+
+## Viewing Chat History
+
+**User**: "Show me the chat history from my 'project1' project."
+
+**Claude**:
+```
+I'll retrieve the chat history from your 'project1' project.
+
+Here's the chat history I found:
+
+Chat: "Understanding React Hooks"
+- You: "Can you explain how useEffect works in React?"
+- Claude: "The useEffect hook in React is used for handling side effects in functional components..."
+
+Chat: "Debugging API Connection"
+- You: "I'm getting a 401 error when connecting to the API. Here's my code..."
+- Claude: "It looks like you're missing the authorization header in your request..."
+```
+
+## Querying Database Tables
+
+**User**: "Can you search for keys related to 'settings' in the ItemTable of my 'project1' project?"
+
+**Claude**:
+```
+I'll search for keys related to 'settings' in the ItemTable of your 'project1' project.
+
+Here are the results:
+1. Key: "workbench.settings.editor"
+   Value: {"mode": "ui", "lastFocusedSettingId": "editor.fontSize"}
+
+2. Key: "settings.language"
+   Value: "en"
+
+3. Key: "settings.theme"
+   Value: "dark"
+```
+
+## Analyzing Chat Data
+
+**User**: "Can you analyze the chat data from my 'project1' project and tell me what topics I've been discussing most frequently?"
+
+**Claude**:
+```
+I'll analyze the chat data from your 'project1' project.
+
+Based on your chat history, here are the most frequent topics you've been discussing:
+1. React Hooks and Components (5 conversations)
+2. API Integration (3 conversations)
+3. CSS Styling (2 conversations)
+4. Performance Optimization (2 conversations)
+5. Debugging (1 conversation)
+
+The most common questions were about state management in React and handling API responses.
+``` 
+
+# Architecture
+
+The server uses the Model Context Protocol (MCP) to expose Cursor's SQLite databases to AI assistants. Key components include:
+
+1. **Lifespan Context Management**: The server uses MCP's lifespan API to efficiently manage resources throughout the server's lifecycle.
+
+2. **CursorDBManager**: Handles the detection and management of Cursor projects and their databases.
+
+3. **Resources**: Expose data from Cursor databases as MCP resources.
+
+4. **Tools**: Provide functionality to query databases and manage projects.
+
+5. **Prompts**: Define reusable templates for AI interactions. -->
+
+# How It Works
+
+The server scans your Cursor installation directory to find project databases (state.vscdb files). It then exposes these databases through MCP resources and tools, allowing AI assistants to query and analyze the data.
+
+# Notes
+1. Cursor stores AI conversations in different places. Increasingly, chats are stored as "composerData" under globalStorage/state.vscdb. If you don't get results when asking about chats for recent projects, try asking for composers.
+2. This was written on a Mac. YMMV with other OS
+
+# Shameless Plug
+<img src="./img/cursor-journal-logo_thumbnail.jpg" width="150" />
+
+Like this? Try [Cursor Journal](https://medium.com/@jbdamask/building-cursor-journal-with-cursor-77445026a08c) to create DevLogs directly from Cursor chat history!
+
+# License
+
+MIT 

iflow_mcp_jbdamask_cursor_db_mcp-0.1.0/README.md

@@ -0,0 +1,236 @@
+# 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.
+
+<!-- __Claude__
+![In Claude GIF](./img/cursor-db-mcp-claude.gif) -->
+
+__Cursor__
+![In Cursor GIF](./img/cursor-db-mcp-in-cursor.gif)
+
+
+## Prerequisites
+
+Cursor IDE
+<!-- Claude Desktop (if you want to use MCP in Claude) -->
+
+## Installation
+
+### Easy Installation
+
+Use the provided installation script to install all dependencies:
+
+```bash
+python install.py
+```
+
+This script will install:
+- Basic MCP server and dependencies
+
+<!-- ### Manual Installation
+
+1. Clone this repository:
+```bash
+git clone https://github.com/yourusername/cursor-db-mcp.git
+cd cursor-db-mcp
+```
+
+2. Install basic dependencies:
+```bash
+pip install -r requirements.txt
+```
+
+3. Install MCP CLI tools (optional, for testing):
+```bash
+pip install 'mcp[cli]'  # Note the quotes around mcp[cli]
+```
+
+If the above command fails, you can install the CLI dependencies directly:
+```bash
+pip install typer rich
+``` -->
+
+<!-- ## Usage
+
+### Using with Claude Desktop
+
+1. Install the MCP server in Claude Desktop:
+```bash
+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
+
+Note: If Claude shows an error connecting to this MCP it's likely because it can't find uv. To fix this, change the command value to include the fully qualified path to uv. For example:
+```
+    "Cursor DB Manager": {
+      "command": "/Users/johndamask/.local/bin/uv",
+      "args": [
+        "run",
+        "--with",
+        "mcp[cli]",
+        "mcp",
+        "run",
+        "/Users/johndamask/code/cursor-db-mcp/cursor-db-mcp-server.py"
+      ]
+    }
+``` -->
+
+## Using with Cursor IDE
+
+1. Open Cursor and navigate to Settings->Cursor Settings->MCP. 
+2. Click: Add new MCP server
+3. Name: Cursor DB MCP; Type: Command
+4. Command: \<fully qualified path to\>uv run --with mcp[cli] mcp run \<fully qualified path to\>/cursor-db-mcp-server.py 
+
+![Cursor DB MCP](./img/cursor-db-mcp.png)
+
+Now you can ask questions about the database or retrieve info about historical chats.
+
+![DB structure](./img/cursor-db-structure.png)
+
+![DB keys](./img/cursor-db-keys.png)
+
+### Using with Claude Desktop 
+
+[Installing MCP servers for Claude Desktop](https://modelcontextprotocol.io/quickstart/user)
+
+Add this to your claude_desktop_config.json file
+```
+    "cursor-db-mcp": {
+      "command": "<fully qualified path to >/uv",
+      "args": [
+        "run",
+        "--with",
+        "mcp[cli]",
+        "mcp",
+        "run",
+        "<fully qualified path to >/cursor-db-mcp-server.py"
+      ]
+    }
+```
+
+
+![Cursor DB fuzzy search](./img/mcp-cursor-db-search.png)
+
+## Available Resources
+
+- `cursor://projects` - List all available Cursor projects
+- `cursor://projects/detailed` - List projects with detailed information
+- `cursor://projects/{project_name}/chat` - Get chat data for a specific project
+- `cursor://projects/{project_name}/composers` - Get composer IDs for a specific project
+- `cursor://composers/{composer_id}` - Get data for a specific composer
+
+## Available Tools
+
+- `query_table` - Query a specific table in a project's database
+- `refresh_databases` - Refresh the list of database paths
+
+
+<!-- # Example Usage with Claude
+
+## Listing Projects
+
+**User**: "Can you show me a list of my Cursor projects?"
+
+**Claude**: 
+```
+I'll retrieve a list of your Cursor projects.
+
+Here are the Cursor projects I found:
+- project1 (path: /Users/username/Library/Application Support/Cursor/User/workspaceStorage/abc123/state.vscdb)
+- project2 (path: /Users/username/Library/Application Support/Cursor/User/workspaceStorage/def456/state.vscdb)
+- custom-project (path: /Users/username/code/custom-project/state.vscdb)
+```
+
+## Viewing Chat History
+
+**User**: "Show me the chat history from my 'project1' project."
+
+**Claude**:
+```
+I'll retrieve the chat history from your 'project1' project.
+
+Here's the chat history I found:
+
+Chat: "Understanding React Hooks"
+- You: "Can you explain how useEffect works in React?"
+- Claude: "The useEffect hook in React is used for handling side effects in functional components..."
+
+Chat: "Debugging API Connection"
+- You: "I'm getting a 401 error when connecting to the API. Here's my code..."
+- Claude: "It looks like you're missing the authorization header in your request..."
+```
+
+## Querying Database Tables
+
+**User**: "Can you search for keys related to 'settings' in the ItemTable of my 'project1' project?"
+
+**Claude**:
+```
+I'll search for keys related to 'settings' in the ItemTable of your 'project1' project.
+
+Here are the results:
+1. Key: "workbench.settings.editor"
+   Value: {"mode": "ui", "lastFocusedSettingId": "editor.fontSize"}
+
+2. Key: "settings.language"
+   Value: "en"
+
+3. Key: "settings.theme"
+   Value: "dark"
+```
+
+## Analyzing Chat Data
+
+**User**: "Can you analyze the chat data from my 'project1' project and tell me what topics I've been discussing most frequently?"
+
+**Claude**:
+```
+I'll analyze the chat data from your 'project1' project.
+
+Based on your chat history, here are the most frequent topics you've been discussing:
+1. React Hooks and Components (5 conversations)
+2. API Integration (3 conversations)
+3. CSS Styling (2 conversations)
+4. Performance Optimization (2 conversations)
+5. Debugging (1 conversation)
+
+The most common questions were about state management in React and handling API responses.
+``` 
+
+# Architecture
+
+The server uses the Model Context Protocol (MCP) to expose Cursor's SQLite databases to AI assistants. Key components include:
+
+1. **Lifespan Context Management**: The server uses MCP's lifespan API to efficiently manage resources throughout the server's lifecycle.
+
+2. **CursorDBManager**: Handles the detection and management of Cursor projects and their databases.
+
+3. **Resources**: Expose data from Cursor databases as MCP resources.
+
+4. **Tools**: Provide functionality to query databases and manage projects.
+
+5. **Prompts**: Define reusable templates for AI interactions. -->
+
+# How It Works
+
+The server scans your Cursor installation directory to find project databases (state.vscdb files). It then exposes these databases through MCP resources and tools, allowing AI assistants to query and analyze the data.
+
+# Notes
+1. Cursor stores AI conversations in different places. Increasingly, chats are stored as "composerData" under globalStorage/state.vscdb. If you don't get results when asking about chats for recent projects, try asking for composers.
+2. This was written on a Mac. YMMV with other OS
+
+# Shameless Plug
+<img src="./img/cursor-journal-logo_thumbnail.jpg" width="150" />
+
+Like this? Try [Cursor Journal](https://medium.com/@jbdamask/building-cursor-journal-with-cursor-77445026a08c) to create DevLogs directly from Cursor chat history!
+
+# License
+
+MIT 

iflow_mcp_jbdamask_cursor_db_mcp-0.1.0/cursor_db_mcp/__init__.py

@@ -0,0 +1,3 @@
+from cursor_db_mcp.server import main
+
+__all__ = ["main"]

iflow_mcp_jbdamask_cursor_db_mcp-0.1.0/cursor_db_mcp/__main__.py

@@ -0,0 +1,4 @@
+from cursor_db_mcp import main
+
+if __name__ == "__main__":
+    main()