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 | sh

与 Claude Desktop 一起使用

添加到你的claude_desktop_config.json 。你需要在--with参数中添加相应的数据库驱动程序。

注意：新版本发布后，可能需要长达 600 秒的时间清除本地缓存，这会导致 uv 报错。重新启动 MCP 客户端即可解决此错误。

SQLite（Python 内置）

{
  "mcpServers": {
    "my_sqlite_db": {
      "command": "uvx",
      "args": ["--from", "mcp-alchemy==2025.04.16.110003",
               "--refresh-package", "mcp-alchemy", "mcp-alchemy"],
      "env": {
        "DB_URL": "sqlite:///path/to/database.db"
      }
    }
  }
}

PostgreSQL

{
  "mcpServers": {
    "my_postgres_db": {
      "command": "uvx",
      "args": ["--from", "mcp-alchemy==2025.04.16.110003", "--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.04.16.110003", "--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.04.16.110003", "--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.04.16.110003", "--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.04.16.110003", "--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"],
...

贡献

热烈欢迎大家贡献代码！无论是错误报告、功能请求、文档改进还是代码贡献，所有意见都弥足珍贵。欢迎：

打开问题报告错误或建议功能
提交带有改进的拉取请求
增强文档或分享您的使用示例
提出问题并分享您的经验

目标是使与 Claude 的数据库交互变得更好，您的见解和贡献有助于实现这一目标。

执照

Mozilla 公共许可证版本 2.0

我的其他法学硕士项目

MCP Redmine - 让 Claude Desktop 管理您的 Redmine 项目和问题。
MCP Notmuch Sendmail - 使用 notmuch 的 Claude Desktop 电子邮件助手。
Diffpilot - 具有文件分组和标记功能的多列 git diff 查看器。
Claude 本地文件- 访问 Claude Desktop 工件中的本地文件。

MCP Alchemy

Integrations