Talk with Your Database Using MCP

基本能力

产品定位

mcp-python 是一个数据库交互工具，旨在简化开发人员与数据库的交互过程，提高开发效率。

核心功能

1. 数据库交互：支持 PostgreSQL、MySQL、MariaDB、SQLite 等多种数据库。
2. 自动化配置：通过 Docker Compose 快速启动数据库并填充测试数据。
3. 集成 Claude Desktop：与 Claude Desktop 无缝集成，提供便捷的数据库操作界面。
4. 环境变量管理：支持通过 .env 文件配置环境变量。
5. 高性能 Python 包管理：使用 uv 作为 Python 包管理器，提升性能。

适用场景

1. 开发测试：快速启动测试数据库并填充数据。
2. 数据库管理：通过 Claude Desktop 进行数据库查询和管理。
3. 自动化脚本：集成到自动化脚本中，简化数据库操作流程。

工具列表

1. Docker Compose：用于启动和管理数据库容器。
2. Claude Desktop：提供图形化界面与数据库交互。
3. uv：高性能 Python 包管理器，用于运行 MCP 服务器。

常见问题解答

1. 如何安装 Docker Compose？
2. 参考 Docker Compose 安装指南。
3. 如何配置环境变量？
4. 复制 .env.example 文件并重命名为 .env，然后根据需要进行修改。
5. 如何启动 MCP 服务器？
6. 确保配置文件正确，然后启动 Claude Desktop，MCP 服务器将自动启动。

使用教程

使用依赖

1. 安装 Docker Compose bash # 参考官方安装指南：https://docs.docker.com/compose/install/
2. 安装 Claude Desktop
3. 下载并安装 Claude Desktop。
4. 安装 uv bash curl -LsSf https://astral.sh/uv/install.sh | sh

安装教程

1. 设置环境变量 bash cp .env.example .env
2. 启动 PostgreSQL 数据库 bash docker-compose up -d
3. 配置 MCP 服务器
4. 编辑配置文件，确保路径和环境变量正确。
5. 启动 MCP 服务器
6. 启动 Claude Desktop，MCP 服务器将自动启动。

调试方式

1. 检查 Docker 容器状态 bash docker-compose ps
2. 查看 MCP 服务器日志
3. 通过 Claude Desktop 的日志功能查看 MCP 服务器的运行状态。
4. 验证数据库连接 bash psql -U postgres -h localhost -p 5432 -d mydatabase

许可证

None