MCP Alchemy

已认证

MCP Alchemy是一个连接Claude Desktop与多种数据库的工具，支持SQL查询、数据库结构分析和数据报告生成。

数据库开发者工具 #数据库工具 #SQL助手 #数据分析 .Python

评分 : 4.2分

下载量 : 19.7K

更新时间 : 2025-04-29

打开站点

什么是MCP Alchemy?

MCP Alchemy通过将Claude Desktop直接连接到你的数据库，帮助你探索、理解和操作数据库。它能生成SQL查询建议、展示表关系、分析大数据集并创建报告。

如何使用MCP Alchemy?

只需在Claude Desktop配置中添加数据库连接信息，即可开始使用MCP Alchemy进行数据分析。

适用场景

适用于需要快速了解数据库结构、编写SQL查询、分析数据集的开发人员和技术人员。

主要功能

数据库结构探索

帮助用户查看和理解数据库中的表及其关系。

SQL查询助手

提供SQL查询建议并验证查询语句的正确性。

大数据集分析

支持处理非常大的数据集，并生成详细的分析报告。

本地文件集成

通过claude-local-files访问完整查询结果。

优势

支持多种主流数据库（如PostgreSQL、MySQL、SQLite等）。

直观易用的界面设计。

强大的大数据集分析能力。

无需编写复杂代码即可完成数据库操作。

局限性

对于某些特殊数据库可能需要安装特定驱动。

依赖于Claude Desktop的运行环境。

对极大规模数据集的性能可能有限。

如何使用

安装uv工具

确保已安装uv工具，用于启动MCP Alchemy服务。

配置Claude Desktop

在Claude Desktop的配置文件中添加MCP Alchemy服务。

测试连接

启动Claude Desktop并检查是否成功连接到数据库。

使用案例

查询所有用户

获取数据库中所有用户的列表。

分析订单数据

统计每个用户的订单数量。

常见问题

MCP Alchemy支持哪些数据库？

如何处理超大规模数据集？

安装

复制以下命令到你的Client进行配置

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

{
  "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"
      }
    }
  }
}

{
  "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"
      }
    }
  }
}

{
  "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"
      }
    }
  }
}

{
  "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"
      }
    }
  }
}

注意：您的密钥属于敏感信息，请勿与任何人分享。

🚀 MCP Alchemy 项目文档

MCP Alchemy 是一款强大的工具，旨在增强 Claude Desktop 与数据库的交互能力。借助该工具，Claude 能够直接访问和操作各类数据库，并获取相关数据信息。

🚀 快速开始

MCP Alchemy 可让 Claude 直接与数据库交互，获取所需数据信息。下面为你介绍其安装与使用的基本步骤。

📦 安装指南

克隆仓库

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

安装依赖

按需安装数据库驱动：

uv pip install psycopg2-binary

配置Claude Desktop

将以下内容添加到 claude_desktop_config.json 中：

"command": "uv",
"args": ["run", "--directory", "/path/to/mcp-alchemy", "-m", "mcp_alchemy.server", "main"],

✨ 主要特性

工具（Tools）

all_table_names
- 功能：获取数据库中所有表的名称。
- 输入：无
- 输出：逗号分隔的表名列表。
```
users, orders, products, categories
```
filter_table_names
- 功能：根据子字符串查找表。
- 输入：q（字符串）
- 输出：匹配的表名。
```
Input: "user"
Output: "users, user_roles, user_permissions"
```
schema_definitions
- 功能：获取指定表的详细架构信息。
- 输入：table_names（字符串数组）
- 输出：包括列名称、类型、主键、外键关系和可空标志等表定义。
```
users:
    id: INTEGER, primary key, autoincrement
    email: VARCHAR(255), nullable
    created_at: DATETIME
    
    Relationships:
      id -> orders.user_id
```
execute_query
- 功能：执行 SQL 查询并以垂直格式输出结果。
- 输入：query（字符串）、可选的 params（对象）
- 输出：整洁的垂直格式结果，支持大结果集的智能截断和完整的上下文窗口外数据访问。
```
1. 行
id: 123
name: John Doe
created_at: 2024-03-15T14:30:00
email: NULL

Result: 1 rows
```