数据库交互工具

MCP是一个通过Claude Desktop与PostgreSQL、MySQL、MariaDB、SQLite等数据库交互的工具,简化数据库操作流程。

  • by rhabraken
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 rhabraken/mcp-python

使用说明

使用MCP与数据库对话

本指南解释了如何设置和运行MCP服务器以与您的 使用Claude Desktop的PostgreSQL数据库。它也应该与MySQL兼容, MariaDB,SQLite,因为它在幕后使用sqlalchemy。该项目建立在 顶端https://github.com/runekaagaard/mcp-alchemy

注: 本指南假设您对Docker有基本的了解, 环境变量和CLI使用情况。


先决条件

  • Docker Compose: 安装说明
  • 克劳德桌面: 点击此处下载
  • 紫外线:一个现代的高性能Python包管理器。如果没有安装, 请按照以下说明进行操作。

1.设置环境变量

  1. 复制并重命名环境文件
    复制提供的 .env.example 文件并将其重命名为 .env:
    cp .env.example .env
    

2.设置克劳德桌面

  1. 下载并安装Claude Desktop
    访问 克劳德桌面下载页面 和 安装应用程序。

3.使用伪数据启动PostgreSQL数据库

  1. 运行Docker Compose
    确保Docker Compose已安装并运行:
    docker-compose up -d
    
    • 此命令将在以下位置启动PostgreSQL数据库 localhost:5432 和 用虚拟数据填充它。

4.安装 uv (如果尚未安装)

  1. 安装 uv
    执行以下命令进行安装 uv:
    curl -LsSf https://astral.sh/uv/install.sh | sh
    

5.配置并启动MCP服务器

  1. 创建/更新MCP服务器配置
    将以下JSON配置保存在MCP服务器配置文件中(调整 路径(如有必要):

    {
      "mcpServers": {
        "my_database": {
          "command": "uv",
          "args": [
            "--directory",
            "/directory/where/this/app/is/located/app/",
            "run",
            "server.py"
          ],
          "env": {
            "DB_URL": "postgresql://postgres:password@localhost:5432/mydatabase"
          }
        }
      }
    }
    
    • 提示: 如果 uv 如果安装在非标准位置,请更新 "command" 值以反映可执行文件的完整路径。
  2. 启动MCP服务器
    配置就绪后,MCP服务器将自动启动每个 克劳德桌面启动的时间。


6.享受您的设置

  • 打开 克劳德桌面.
  • 该工具将自动调用您的MCP服务器,使您能够进行交互 与您的数据库无缝连接。

总结

  1. 设置环境变量:复制 .env.example 向 .env.
  2. 安装并运行Claude Desktop:从下载 克劳德桌面.
  3. 使用Docker Compose启动PostgreSQL:运行 docker-compose up 开始 带有虚拟数据的数据库。
  4. 安装 uv:如有必要,运行提供的安装命令。
  5. 配置MCP服务器:更新配置文件并确保路径和 环境变量是正确的。
  6. 启动并享受:启动Claude Desktop,开始与您的 通过MCP访问数据库。

如果您遇到任何问题或需要进一步帮助,请参阅 相关文档或联系您的支持团队。

编码愉快!