Newsletter
Join the Community
Subscribe to our newsletter for the latest news and updates
MCP Database Utilities enables secure AI data analysis across versatile databases (sqlite, mysql, postgres) via unified, secured connections.
MCP Database Utilities 是一个多功能的 MCP 服务,它使您的 AI 能够通过统一的连接配置安全地访问各种类型的数据库(SQLite、MySQL、PostgreSQL 等)进行数据分析。
您可以将其视为 AI 系统和数据库之间的安全桥梁,允许 AI 在不直接访问数据库或冒数据修改风险的情况下读取和分析您的数据。
MCP Database Utilities 采用安全优先的架构设计,非常适合注重数据保护的企业、初创公司和个人用户。我们的全面安全措施包括:
有关我们安全架构的技术详情,请参阅技术指南。
选择以下一种方法进行安装:
此方法使用uvx
,它是Python包管理工具"uv"的一部分。以下是设置步骤:
首先安装uv和uvx:
在macOS或Linux上:
curl -LsSf https://astral.sh/uv/install.sh |
sh
在Windows上:
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
安装后,验证uv是否正确安装:
uv --version
# 应显示类似:uv 0.5.5 (Homebrew 2024-11-27)
创建配置文件,命名为 config.yaml
,包含您的数据库连接详情:
connections:
postgres:
type: postgres
host: localhost
port: 5432
dbname: my_database
user: my_user
password: my_password
有关高级配置选项(SSL连接、连接池等), 请查看我们全面的配置示例集锦文档。
将此配置添加到您的AI客户端:
对于基于JSON的MCP客户端:
找到并编辑您客户端的MCP配置文件:
~/Library/Application Support/Claude/claude_desktop_config.json
~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
~/.cursor/mcp.json
在JSON文件中添加以下配置:
"dbutils": {
"command": "uvx",
"args": [
"mcp-dbutils",
"--config",
"/完整/路径/到您的/config.yaml"
]
}
uvx设置的重要注意事项:
- 将
/完整/路径/到您的/config.yaml
替换为您配置文件的实际完整路径- 如果您收到uvx未找到的错误,请确保已成功完成步骤1
- 您可以通过在终端中输入
uv --version
来验证uvx是否已安装
如果您没有Docker,请从docker.com安装
创建配置文件(详见下一节)
将此配置添加到您的AI客户端:
对于基于JSON的MCP客户端:
找到并编辑您客户端的MCP配置文件:
~/Library/Application Support/Claude/claude_desktop_config.json
~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
在JSON文件中添加以下配置:
"dbutils": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-v",
"/完整/路径/到您的/config.yaml:/app/config.yaml",
"-v",
"/完整/路径/到您的/sqlite.db:/app/sqlite.db", // 仅SQLite数据库需要
"mcp/dbutils",
"--config",
"/app/config.yaml"
]
}
Docker的重要注意事项:
- 将
/完整/路径/到您的/config.yaml
替换为您配置文件的实际完整路径- 对于SQLite数据库,同样替换sqlite.db的路径为您的实际数据库路径
- 对于其他类型的数据库,完全删除SQLite卷行
此方法自动安装并配置服务到Claude:
npx -y @smithery/cli install @donghao1393/mcp-dbutils --client claude
安装完成后,直接跳到"使用服务"部分。
正确安装和配置后,您的AI现在可以:
验证一切正常工作:
如果遇到问题,请检查:
您: