MCP Alchemy

MCP Alchemy

一个MCP（模型上下文协议）服务器，使LLM能够访问和了解如SQLite、Postgresql、MySQL & MariaDB、Oracle以及MS-SQL等关系型数据库。

GitHub
Created Byrunekaagaardrunekaagaard

简介

MCP Alchemy 将 Claude Desktop 与您的数据库连接，使 Claude 能够查询和分析您的数据。支持 PostgreSQL、MySQL、MariaDB、SQLite、Oracle、MS SQL Server 等多种数据库。

MCP Alchemy在行动

核心功能

  • 探索和理解数据库结构
  • 编写和验证 SQL 查询
  • 显示表之间的关系
  • 分析数据集并创建报告

安装步骤

  1. 克隆仓库：

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

  2. 确保已安装 uv：

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

  3. 配置 Claude Desktop： 在 claude_desktop_config.json 文件中添加：

    {
  "mcpServers": {
    "my_database": {
      "command": "uv",
      "args": ["--directory", "/path/to/mcp-alchemy", "run", "server.py"],
      "env": {
        "DB_URL": "mysql+pymysql://user:password@localhost/dbname"
      }
    }
  }
}

环境变量

  • DB_URL: 必需，SQLAlchemy 数据库 URL
  • CLAUDE_LOCAL_FILES_PATH: 可选，设置输出完整结果集的目录
  • EXECUTE_QUERY_MAX_CHARS: 可选，最大输出长度（默认 4000）

支持的功能

主要工具

  • all_table_names: 获取所有表名
  • filter_table_names: 查找匹配子字符串的表
  • schema_definitions: 获取表的详细模式
  • execute_query: 执行 SQL 查询并以垂直格式显示结果

Claude Local Files 集成

配置 claude-local-files 后，可以:

  • 访问完整结果集
  • 生成详细报告和可视化
  • 对大型数据集进行深入分析

数据库驱动程序

默认支持：

  • SQLite (内置)
  • MySQL/MariaDB (通过 pymysql)
  • PostgreSQL (通过 psycopg2-binary)

其他数据库需安装相应驱动程序：

# Microsoft SQL Server
uv pip install pymssql

# Oracle
uv pip install cx_oracle

许可证

Mozilla Public License Version 2.0