使用说明
使用MCP与数据库对话
本指南解释了如何设置和运行MCP服务器以与您的 使用Claude Desktop的PostgreSQL数据库。它也应该与MySQL兼容, MariaDB,SQLite,因为它在幕后使用sqlalchemy。该项目建立在 顶端https://github.com/runekaagaard/mcp-alchemy
注: 本指南假设您对Docker有基本的了解, 环境变量和CLI使用情况。
先决条件
1.设置环境变量
- 复制并重命名环境文件
复制提供的.env.example文件并将其重命名为.env:cp .env.example .env
2.设置克劳德桌面
- 下载并安装Claude Desktop
访问 克劳德桌面下载页面 和 安装应用程序。
3.使用伪数据启动PostgreSQL数据库
- 运行Docker Compose
确保Docker Compose已安装并运行:docker-compose up -d- 此命令将在以下位置启动PostgreSQL数据库
localhost:5432和 用虚拟数据填充它。
- 此命令将在以下位置启动PostgreSQL数据库
4.安装 uv (如果尚未安装)
- 安装
uv
执行以下命令进行安装uv:curl -LsSf https://astral.sh/uv/install.sh | sh
5.配置并启动MCP服务器
-
创建/更新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"值以反映可执行文件的完整路径。
- 提示: 如果
-
启动MCP服务器
配置就绪后,MCP服务器将自动启动每个 克劳德桌面启动的时间。
6.享受您的设置
- 打开 克劳德桌面.
- 该工具将自动调用您的MCP服务器,使您能够进行交互 与您的数据库无缝连接。
总结
- 设置环境变量:复制
.env.example向.env. - 安装并运行Claude Desktop:从下载 克劳德桌面.
- 使用Docker Compose启动PostgreSQL:运行
docker-compose up开始 带有虚拟数据的数据库。 - 安装
uv:如有必要,运行提供的安装命令。 - 配置MCP服务器:更新配置文件并确保路径和 环境变量是正确的。
- 启动并享受:启动Claude Desktop,开始与您的 通过MCP访问数据库。
如果您遇到任何问题或需要进一步帮助,请参阅 相关文档或联系您的支持团队。
编码愉快!