MCP 炼金术
状态：运行良好，日常使用中没有任何已知错误。
状态2：我刚刚把这个包添加到PyPI，并更新了使用说明。如有任何问题，请报告 :)
让 Claude 成为您的数据库专家！MCP Alchemy 将 Claude Desktop 直接连接到您的数据库，使其能够：
帮助您探索和了解数据库结构
协助编写和验证 SQL 查询
显示表之间的关系
分析大型数据集并创建报告
Claude Desktop 可以使用claude-local-files分析和创建非常大的数据集的工件。
可与 PostgreSQL、MySQL、MariaDB、SQLite、Oracle、MS SQL Server、CrateDB 以及许多其他与 SQLAlchemy 兼容的数据库配合使用。
安装
确保已安装 uv：
# Install uv if you haven't already
curl -LsSf https://astral.sh/uv/install.sh | shRelated MCP server: MCPDB - Database Access MCP Server
与 Claude Desktop 一起使用
添加到你的claude_desktop_config.json 。你需要在--with参数中添加相应的数据库驱动程序。
注意：新版本发布后，可能需要长达 600 秒的时间清除本地缓存，这会导致 uv 报错。重新启动 MCP 客户端即可解决此错误。
SQLite（Python 内置）
{
"mcpServers": {
"my_sqlite_db": {
"command": "uvx",
"args": ["--from", "mcp-alchemy==2025.5.2.210242",
"--refresh-package", "mcp-alchemy", "mcp-alchemy"],
"env": {
"DB_URL": "sqlite:////absolute/path/to/database.db"
}
}
}
}PostgreSQL
{
"mcpServers": {
"my_postgres_db": {
"command": "uvx",
"args": ["--from", "mcp-alchemy==2025.5.2.210242", "--with", "psycopg2-binary",
"--refresh-package", "mcp-alchemy", "mcp-alchemy"],
"env": {
"DB_URL": "postgresql://user:password@localhost/dbname"
}
}
}
}MySQL/MariaDB
{
"mcpServers": {
"my_mysql_db": {
"command": "uvx",
"args": ["--from", "mcp-alchemy==2025.5.2.210242", "--with", "pymysql",
"--refresh-package", "mcp-alchemy", "mcp-alchemy"],
"env": {
"DB_URL": "mysql+pymysql://user:password@localhost/dbname"
}
}
}
}微软 SQL 服务器
{
"mcpServers": {
"my_mssql_db": {
"command": "uvx",
"args": ["--from", "mcp-alchemy==2025.5.2.210242", "--with", "pymssql",
"--refresh-package", "mcp-alchemy", "mcp-alchemy"],
"env": {
"DB_URL": "mssql+pymssql://user:password@localhost/dbname"
}
}
}
}甲骨文
{
"mcpServers": {
"my_oracle_db": {
"command": "uvx",
"args": ["--from", "mcp-alchemy==2025.5.2.210242", "--with", "cx_oracle",
"--refresh-package", "mcp-alchemy", "mcp-alchemy"],
"env": {
"DB_URL": "oracle+cx_oracle://user:password@localhost/dbname"
}
}
}
}CrateDB
{
"mcpServers": {
"my_cratedb": {
"command": "uvx",
"args": ["--from", "mcp-alchemy==2025.5.2.210242", "--with", "sqlalchemy-cratedb>=0.42.0.dev1",
"--refresh-package", "mcp-alchemy", "mcp-alchemy"],
"env": {
"DB_URL": "crate://user:password@localhost:4200/?schema=testdrive"
}
}
}
}要连接到 CrateDB Cloud，请使用类似crate://user:password@example.aks1.westeurope.azure.cratedb.net:4200?ssl=true URL。
环境变量
DB_URL：SQLAlchemy数据库 URL （必需）CLAUDE_LOCAL_FILES_PATH：完整结果集的目录（可选）EXECUTE_QUERY_MAX_CHARS：最大输出长度（可选，默认 4000）
API
工具
所有表名称
返回数据库中所有表名
无需输入
返回以逗号分隔的 GXP8 表列表
过滤表名称
查找与子字符串匹配的表
输入：
q（字符串）返回匹配的表名 GXP9
模式定义
获取指定表的详细架构
输入：
table_names（string[]）返回表定义包括：
列名和类型
主键
外键关系
可空标志 GXP10
执行查询
使用垂直输出格式执行 SQL 查询
输入：
query（字符串）：SQL 查询params（对象，可选）：查询参数
以清晰的垂直格式返回结果：GXP11
特征：
智能截断大型结果
通过claude-local-files集成访问完整结果集
清除 NULL 值显示
ISO 格式的日期
清晰的行分隔
克劳德本地文件
当配置了claude-local-files时：
访问 Claude 上下文窗口之外的完整结果集
生成详细的报告和可视化效果
对大型数据集进行深度分析
导出结果以供进一步处理
当设置CLAUDE_LOCAL_FILES_PATH时，集成会自动激活。
发展
首先克隆 github 存储库，安装依赖项和您选择的数据库驱动程序：
git clone git@github.com:runekaagaard/mcp-alchemy.git
cd mcp-alchemy
uv sync
uv pip install psycopg2-binary然后在 claude_desktop_config.json 中进行设置：
...
"command": "uv",
"args": ["run", "--directory", "/path/to/mcp-alchemy", "-m", "mcp_alchemy.server", "main"],
...我的其他法学硕士项目
MCP Redmine - 让 Claude Desktop 管理您的 Redmine 项目和问题。
MCP Notmuch Sendmail - 使用 notmuch 的 Claude Desktop 电子邮件助手。
Diffpilot - 具有文件分组和标记功能的多列 git diff 查看器。
Claude 本地文件- 访问 Claude Desktop 工件中的本地文件。
MCP 目录列表
MCP Alchemy 列在以下 MCP 目录站点和存储库中：
贡献
热烈欢迎大家贡献代码！无论是错误报告、功能请求、文档改进还是代码贡献，所有意见都弥足珍贵。欢迎：
打开问题报告错误或建议功能
提交带有改进的拉取请求
增强文档或分享您的使用示例
提出问题并分享您的经验
目标是使与 Claude 的数据库交互变得更好，您的见解和贡献有助于实现这一目标。
执照
Mozilla 公共许可证版本 2.0
This server cannot be installed
Resources
Looking for Admin?
Admins can modify the Dockerfile, update the server description, and track usage metrics. If you are the server author, to access the admin panel.