数据库探索器 MCP 工具

一个强大的模型上下文协议（MCP）工具，用于探索和管理不同类型的数据库，包括 PostgreSQL、MySQL 和 Firestore。

功能

• 多数据库支持

  • PostgreSQL
  • MySQL
  • Firestore

• 数据库操作

  • 连接到数据库
  • 列出表
  • 查看触发器
  • 列出函数
  • 执行 SQL 查询（PostgreSQL 和 MySQL）
  • 导出表结构
  • 导出表数据

与 Cursor 的集成

在将工具添加到 Cursor 之前，需要构建项目：

1. 克隆仓库
2. 安装依赖项：

   npm install
   

3. 构建项目：

   npm run build
   

要将工具添加到 Cursor：

1. 打开 Cursor 设置
2. 导航到“模型上下文协议（MCP）”部分
3. 点击“添加新工具”
4. 填写以下详细信息：

   {
     "name": "database-explorer",
     "command": "node /path/to/project/dist/index.js",
     "description": "数据库探索器 MCP 工具"
   }
   

   注意：用实际的项目目录路径替换 /path/to/project。
5. 保存设置
6. 重启 Cursor

使用工具：

1. 设置完成后，可以使用以下命令之一连接到您的数据库：

   • 对于 PostgreSQL：使用 !pg 和连接详情
   • 对于 MySQL：使用 !mysql 和连接详情
   • 对于 Firestore：使用 !firestore 和连接详情

2. 连接后，您可以使用各种数据库操作：

   • 使用 !tables 列出所有表
   • 使用 !triggers 查看触发器
   • 使用 !functions 列出函数
   • 使用 !query 执行 SQL 查询
   • 使用 !export-db 导出表结构
   • 使用 !export-data 导出表数据

请参阅下面的命令部分以获取详细的使用示例。

命令

连接命令

• !pg - 连接到 PostgreSQL 数据库

  {
    "connection": {
      "host": "主机名",
      "port": 5432,
      "database": "数据库名",
      "user": "用户名",
      "password": "密码"
    }
  }
  

• !mysql - 连接到 MySQL 数据库

  {
    "connection": {
      "host": "主机名",
      "port": 3306,
      "database": "数据库名",
      "user": "用户名",
      "password": "密码"
    }
  }
  

• !firestore - 连接到 Firestore 数据库

  {
    "connection": {
      "projectId": "您的项目ID",
      "keyFilename": "密钥文件路径/to/keyfile.json"
    }
  }
  

数据库操作命令

• !tables - 列出连接数据库中的所有表
• !triggers - 列出连接数据库中的所有触发器
• !functions - 列出连接数据库中的所有函数
• !query - 执行 SQL 查询（仅限 PostgreSQL 和 MySQL）

  {
    "query": "SELECT * FROM 表名"
  }
  

• !export-db - 导出表结构

  {
    "table": "表名"
  }
  

• !export-data - 将表数据导出为 INSERT 语句

  {
    "table": "表名"
  }
  

要求

• Node.js
• 必需的数据库驱动程序：
  • pg 用于 PostgreSQL
  • mysql2 用于 MySQL
  • @google-cloud/firestore 用于 Firestore

使用方法

1. 确保您拥有必要的数据库凭据
2. 使用适当的连接命令连接到您的数据库
3. 使用可用命令来探索和管理您的数据库

错误处理

• 该工具包含全面的错误处理功能，涵盖：
  • 连接失败
  • 查询执行错误
  • 结构和数据导出问题
  • 无效的数据库操作

备注

• 由于其 NoSQL 特性，Firestore 支持的操作有限
• SQL 操作仅适用于 PostgreSQL 和 MySQL