MCP Alchemy

已認證

MCP Alchemy是一個連接Claude Desktop與多種數據庫的工具，支持SQL查詢、數據庫結構分析和數據報告生成。

數據庫開發者工具 #數據庫工具 #SQL助手 #數據分析 .Python

評分 : 4.2分

下載量 : 12.1K

更新時間 : 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 Desktop 與數據庫高效交互，讓數據操作更便捷。

📦 安裝指南

克隆倉庫

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