使用 MCP 与数据库对话

本指南解释了如何设置和运行 MCP 服务器，以便使用 Claude Desktop 与您的 PostgreSQL 数据库进行交互。由于它在底层使用了 sqlalchemy，因此它也应该适用于 MySQL、MariaDB、SQLite。本项目构建于 https://github.com/runekaagaard/mcp-alchemy 之上。

注意： 本指南假设您对 Docker、环境变量和 CLI 用法有基本的了解。

---

前提条件

• Docker Compose: 安装说明
• Claude Desktop: 在此处下载
• uv: 一款现代、高性能的 Python 包管理器。如果未安装，请按照以下说明进行操作。

---

1. 设置环境变量

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

   cp .env.example .env
   

---

2. 设置 Claude Desktop

1. 下载并安装 Claude Desktop
   访问 Claude Desktop 下载页面 并安装应用程序。

---

3. 使用虚拟数据启动 PostgreSQL 数据库

1. 运行 Docker Compose
   确保已安装 Docker Compose 并运行：

   docker-compose up -d
   

   • 此命令将在 localhost:5432 上启动一个 PostgreSQL 数据库，并使用虚拟数据填充它。

---

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 服务器
   配置完成后，每次启动 Claude Desktop 时，MCP 服务器将自动启动。

---

6. 享受您的设置

• 打开 Claude Desktop。
• 该工具将自动调用您的 MCP 服务器，使您能够无缝地与您的数据库进行交互。

---

总结

1. 设置环境变量：将 .env.example 复制到 .env。
2. 安装并运行 Claude Desktop：从 Claude Desktop 下载。
3. 使用 Docker Compose 启动 PostgreSQL：运行 docker-compose up 以启动带有虚拟数据的数据库。
4. 安装 uv：如果需要，运行提供的安装命令。
5. 配置 MCP 服务器：更新配置文件并确保路径和环境变量正确。
6. 启动并享受：启动 Claude Desktop 以开始通过 MCP 与您的数据库进行交互。

---

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

祝您编码愉快！