MCP Alchemy
2025.04.16
159
Python数据库交互SQL 查询数据分析数据库
MCP Alchemy 是一个数据库交互工具，它允许 Claude Desktop 直接连接到各种数据库，帮助用户探索和理解数据库结构，编写和验证 SQL 查询，显示表之间的关系，分析大型数据集并创建报告。它支持多种数据库，包括 PostgreSQL、MySQL、MariaDB、SQLite、Oracle 和 MS SQL Server 等 SQLAlchemy 兼容的数据库。
View on GitHub
Overview
基本能力
产品定位
MCP Alchemy 是一个数据库交互工具，旨在帮助用户通过 Claude Desktop 直接与数据库进行交互，提供数据库结构探索、SQL 查询编写和验证、数据分析等功能。
核心功能
- 探索和理解数据库结构
- 编写和验证 SQL 查询
- 显示表之间的关系
- 分析大型数据集并创建报告
- 支持多种 SQLAlchemy 兼容的数据库
适用场景
- 数据库结构探索和理解
- SQL 查询编写和验证
- 大型数据集分析和报告生成
工具列表
- all_table_names: 返回数据库中所有表名
- filter_table_names: 根据子字符串查找匹配的表名
- schema_definitions: 获取指定表的详细模式定义
- execute_query: 执行 SQL 查询并以垂直格式返回结果
常见问题解答
- 如何配置数据库连接？通过
DB_URL环境变量设置 SQLAlchemy 数据库 URL。 - 如何处理大型数据集？通过
claude-local-files集成可以访问完整的结果集。
使用教程
使用依赖
确保已安装 uv：
curl -LsSf https://astral.sh/uv/install.sh | sh
安装教程
在 claude_desktop_config.json 中添加配置，示例如下：
SQLite
{
"mcpServers": {
"my_sqlite_db": {
"command": "uvx",
"args": ["--from", "mcp-alchemy==2025.04.08.212652", "mcp-alchemy"],
"env": {
"DB_URL": "sqlite:///path/to/database.db"
}
}
}
}
PostgreSQL
{
"mcpServers": {
"my_postgres_db": {
"command": "uvx",
"args": ["--from", "mcp-alchemy==2025.04.08.212652", "--with", "psycopg2-binary", "mcp-alchemy"],
"env": {
"DB_URL": "postgresql://user:password@localhost/dbname"
}
}
}
}
调试方式
确保 DB_URL 环境变量正确设置，并通过 execute_query 工具测试数据库连接和查询功能。