Cursor DB MCP Server

基本能力

产品定位

Cursor DB MCP Server 是一个专门为 Cursor IDE 设计的数据库访问服务，通过 MCP 协议提供对 Cursor 项目数据的访问能力。

核心功能

1. 访问 Cursor IDE 的 SQLite 数据库
2. 提供项目列表、详细项目信息、项目聊天数据和作曲家信息
3. 支持查询特定数据库表和刷新数据库列表

适用场景

1. AI 助手需要访问 Cursor 项目数据时
2. 开发者需要分析项目历史或聊天记录时
3. 需要查询 Cursor 数据库中的特定信息时

工具列表

1. query_table - 查询项目数据库中的特定表
2. refresh_databases - 刷新数据库路径列表

常见问题解答

1. 如果无法获取最近的聊天记录，可能是因为聊天数据存储在 globalStorage/state.vscdb 中的 "composerData" 下，可以尝试查询作曲家信息。
2. 该服务主要在 Mac 上开发，其他操作系统可能有所不同。

使用教程

使用依赖

1. 需要安装 Cursor IDE

安装教程

使用提供的安装脚本安装所有依赖项：

python install.py

在 Cursor IDE 中使用

1. 打开 Cursor 并导航到 Settings->Cursor Settings->MCP
2. 点击：添加新的 MCP 服务器
3. 名称：Cursor DB MCP；类型：Command
4. 命令：<fully qualified path to>uv run --with mcp[cli] mcp run <fully qualified path to>/cursor-db-mcp-server.py

在 Claude Desktop 中使用

1. 将以下内容添加到 claude_desktop_config.json 文件中：

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

调试方式

安装完成后，可以通过以下方式测试服务是否正常工作： 1. 在 Cursor 或 Claude 中尝试查询项目列表 2. 尝试获取特定项目的聊天历史 3. 使用 query_table 工具查询数据库表

许可证

该项目遵循 Other 开源许可条款，请参阅 Other 了解完整条款。