Back to MCP directory
publicPublicdnsLocal runtime

database-tools

一个让Claude AI直接与MySQL数据库交互的MCP服务器工具

article

README

🚀 数据库工具 - 用于Claude AI

这是一个专为Claude AI打造的数据库工具,借助MCP(模型上下文协议)服务器,它能让Claude AI直接与MySQL数据库进行交互,为数据查询和管理带来极大便利。

🚀 快速开始

此数据库工具允许Claude AI直接与MySQL数据库交互,通过简单的配置和操作,即可让Claude执行各类SQL查询。

✨ 主要特性

  • 数据库查询:可通过Claude对MySQL数据库进行查询操作。
  • 灵活查询执行:能够执行任何有效的SQL查询。
  • 表信息获取:可以获取有关表的信息,包括表的大小和结构。
  • 结果友好展示:对查询结果进行格式化,便于在Claude中轻松阅读。

📦 安装指南

通过Smithery安装

若要通过Smithery自动安装数据库工具,可使用以下命令:

npx -y @smithery/cli install @elber-code/database-tools --client claude

手动安装

若要手动安装并使用此工具,请按以下步骤操作:

  1. 克隆或下载仓库
    git clone [repository-url]
    
    你也可以选择下载并提取ZIP文件。
  2. 安装依赖项 进入项目目录后,运行以下命令:
    npm install
    

📚 详细文档

配置

若要让Claude使用此工具,需要将配置添加到claude_desktop_config.json文件中,该文件通常位于:

C:\Users\YOUR_USER\AppData\Roaming\Claude\claude_desktop_config.json

配置文件的结构如下:

{
  "mcpServers": {
    // 其他现有配置...
    "database-tools": {
      "command": "node",
      "args": [
        "C:\\path\\to\\index.js"
      ]
    }
  }
}

使用方法

配置完成后,你就可以通过Claude与MySQL数据库进行交互,使用以下类似命令:

  1. 列出所有数据库
    “在MySQL中执行查询以显示数据库。”
  2. 查看数据库中的表
    “在MySQL中执行查询以显示name_table表。”
  3. 查询表的大小
    “在MySQL中执行查询以显示name_table表的大小。”
  4. 执行自定义查询
    “在MySQL中执行查询:‘描述您希望查询要做的事情。’”

安全

此工具以mysql.js文件中的配置权限运行。请确保提供的凭据仅具有所需的最少操作权限,以保障数据库安全。

故障排除

若出现连接问题,请检查以下几点:

  • MySQL是否正在运行。
  • mysql.js中的凭证是否正确。
  • Claude配置文件中的路径是否正确。

🔧 技术细节

要查询数据库,只需让Claude询问类似的问题,如“显示所有MySQL数据库”或“用户表的大小是多少?” 该工具会依据这些问题执行相应的SQL查询。

help

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client