mcp-alchemy | 通往MCP之路

MCP Alchemy

状态：运行良好，日常使用中未发现任何已知问题。

状态2：我刚刚将包发布到 PyPI 并更新了使用说明。如有任何问题，请报告 :)

让 Claude 成为你的数据库专家！MCP Alchemy 将 Claude Desktop 直接连接到你的数据库，使其能够：

帮助你探索和理解数据库结构

协助编写和验证 SQL 查询

显示表之间的关系

分析大数据集并生成报告

Claude Desktop 可以使用 claude-local-files 分析和创建超大数据集的工件。

支持 PostgreSQL、MySQL、MariaDB、SQLite、Oracle、MS SQL Server、CrateDB 以及其他众多 SQLAlchemy 兼容的数据库。

安装

确保已安装 uv：

与 Claude Desktop 一起使用

将其添加到你的 claude_desktop_config.json 中。你需要在 --with 参数中添加适当的数据库驱动。

注意：新版本发布后，可能会有最多 600 秒的时间本地缓存被清除，导致 uv 抛出版本错误。重新启动 MCP 客户端即可解决此错误。

SQLite（Python 内置）

PostgreSQL

MySQL/MariaDB

Microsoft SQL Server

Oracle

CrateDB

要连接到 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

工具

all_table_names

返回数据库中所有表的名称
无需输入
返回逗号分隔的表名列表

filter_table_names

查找匹配子字符串的表
输入：q（字符串）
返回匹配的表名

schema_definitions

获取指定表的详细模式
输入：table_names（字符串数组）
返回表定义，包括：

列名和类型
主键
外键关系
可为空标志

execute_query

以垂直输出格式执行 SQL 查询
输入：

query（字符串）：SQL 查询
params（对象，可选）：查询参数

以干净的垂直格式返回结果：
功能：

智能截断大结果
通过 claude-local-files 集成访问完整结果集
干净的 NULL 值显示
ISO 格式日期
清晰的行分隔

Claude Local Files

当配置了 claude-local-files 时：

访问超出 Claude 上下文窗口的完整结果集

生成详细的报告和可视化

对大数据集进行深入分析

导出结果以进行进一步处理

当 CLAUDE_LOCAL_FILES_PATH 设置时，集成会自动激活。

开发

首先克隆 GitHub 仓库，安装依赖项和你选择的数据库驱动：

然后在 claude_desktop_config.json 中设置：

贡献

我们热烈欢迎贡献！无论是错误报告、功能请求、文档改进还是代码贡献——所有的输入都是有价值的。欢迎：

打开问题报告错误或建议功能

提交改进的拉取请求

增强文档或分享你的使用示例

提问并分享你的经验

我们的目标是让与 Claude 的数据库交互更加出色，而你的见解和贡献有助于实现这一目标。

许可证

Mozilla 公共许可证 2.0 版

我的其他 LLM 项目

MCP Redmine - 让 Claude Desktop 管理你的 Redmine 项目和问题。

MCP Notmuch Sendmail - 使用 notmuch 的 Claude Desktop 邮件助手。

Diffpilot - 多列 git diff 查看器，支持文件分组和标记。

Claude Local Files - 在 Claude Desktop 工件中访问本地文件。