MCP Alchemy

MCP Alchemy 是一款专为增强 Claude Desktop 与数据库交互能力而设计的工具。它允许用户通过自然语言与数据库进行交互，执行 SQL 查询、分析数据库结构、生成数据报告，并支持多种主流数据库类型。该工具通过直观的配置和强大的功能，帮助开发人员和技术人员更高效地处理数据库任务。

核心功能

MCP Alchemy 提供了多种核心功能，帮助用户深入了解和操作数据库：

• 数据库结构探索：用户可以通过工具查看数据库中的所有表及其关系，了解表的字段、类型、主键、外键等详细信息。
• SQL 查询助手：支持用户编写和验证 SQL 查询语句，提供查询建议，确保查询的正确性和效率。
• 大数据集分析：能够处理大规模数据集，并生成详细的分析报告，帮助用户从数据中提取有价值的信息。
• 本地文件集成：通过 claude-local-files 功能，用户可以访问超出上下文窗口的完整查询结果，便于进一步分析和处理。

安装方法

安装 MCP Alchemy 需要先安装 uv 工具，并配置相关依赖和数据库驱动。

curl -LsSf https://astral.sh/uv/install.sh | sh

安装完成后，进入项目目录并同步依赖：

git clone git@github.com:runekaagaard/mcp-alchemy.git

cd mcp-alchemy

uv sync

根据需要安装数据库驱动，例如：

uv pip install psycopg2-binary

配置说明

在使用 MCP Alchemy 之前，需要在 Claude Desktop 的配置文件中添加服务配置。以下是一个配置示例：

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

配置完成后，启动 Claude Desktop 并测试连接。

使用方法

MCP Alchemy 提供了多种命令和 API 接口，方便用户执行数据库操作。

all_table_names()

该命令用于获取数据库中所有表的名称。

execute_query('SELECT * FROM users LIMIT 10')

该命令用于执行 SQL 查询并返回结果。

使用示例

以下是 MCP Alchemy 的两个典型使用场景：

• 查询所有用户：通过执行 SQL 查询获取所有用户记录。

SELECT * FROM users;

• 分析订单数据：统计每个用户的订单数量。

SELECT user_id, COUNT(*) AS order_count FROM orders GROUP BY user_id;

环境变量

MCP Alchemy 支持以下环境变量配置：

• DB_URL：SQLAlchemy 数据库 URL（必填）。
• CLAUDE_LOCAL_FILES_PATH：完整结果集的目录路径（可选）。
• EXECUTE_QUERY_MAX_CHARS：最大输出长度（可选，默认 4000）。

与 claude-local-files 的集成

当配置了 claude-local-files 后，MCP Alchemy 可以：

• 访问上下文窗口外的大结果集。
• 生成详细的报告和可视化图表。
• 执行深度数据分析。
• 导出结果进行进一步处理。

适用场景

MCP Alchemy 适用于以下场景：

• 需要快速了解数据库结构的开发人员。
• 需要编写和验证 SQL 查询的数据库管理员。
• 需要分析大数据集并生成报告的数据分析师。

MCP Alchemy 通过直观的界面和强大的功能，帮助用户更高效地处理数据库任务。