Alquimia MCP

Estado: Funciona muy bien y se utiliza a diario sin errores conocidos.

Estado 2: Acabo de añadir el paquete a PyPI y actualicé las instrucciones de uso. Por favor, informen cualquier problema.

¡Deja que Claude sea tu experto en bases de datos! MCP Alchemy conecta Claude Desktop directamente con tus bases de datos, lo que le permite:

Le ayudamos a explorar y comprender la estructura de su base de datos.
Ayudar a escribir y validar consultas SQL.
Muestra relaciones entre tablas
Analizar grandes conjuntos de datos y crear informes
Claude Desktop puede analizar y crear artefactos para conjuntos de datos muy grandes utilizando claude-local-files .

Funciona con PostgreSQL, MySQL, MariaDB, SQLite, Oracle, MS SQL Server, CrateDB y una gran cantidad de otras bases de datos compatibles con SQLAlchemy .

Instalación

Asegúrese de tener instalado el sistema UV:

# Install uv if you haven't already
curl -LsSf https://astral.sh/uv/install.sh | sh

Uso con Claude Desktop

Agregue a su claude_desktop_config.json . Debe agregar el controlador de base de datos apropiado en el parámetro --with .

Nota: Tras el lanzamiento de una nueva versión, la caché local puede tardar hasta 600 segundos en borrarse, lo que provoca que uv genere un error de control de versiones. Reiniciar el cliente MCP soluciona el error.

SQLite (integrado en 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"
      }
    }
  }
}

Microsoft SQL Server

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

Oráculo

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

Base de datos de cajas

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

Para conectarse a CrateDB Cloud, utilice una URL como crate://user:password@example.aks1.westeurope.azure.cratedb.net:4200?ssl=true .

Variables de entorno

DB_URL : URL de la base de datos SQLAlchemy (obligatoria)
CLAUDE_LOCAL_FILES_PATH : Directorio para conjuntos de resultados completos (opcional)
EXECUTE_QUERY_MAX_CHARS : Longitud máxima de salida (opcional, predeterminado 4000)

API

Herramientas

todos los nombres de tablas
- Devolver todos los nombres de tablas en la base de datos
- No se requiere entrada
- Devuelve una lista de tablas separadas por comas GXP8
nombres_de_tabla_de_filtro
- Buscar tablas que coincidan con una subcadena
- Entrada: q (cadena)
- Devuelve los nombres de tabla coincidentes GXP9
definiciones de esquema
- Obtener el esquema detallado para las tablas especificadas
- Entrada: table_names (cadena[])
- Devuelve definiciones de tabla que incluyen:
  - Nombres y tipos de columnas
  - Claves primarias
  - Relaciones de clave externa
  - Banderas que aceptan valores nulos GXP10
ejecutar_consulta
- Ejecutar consulta SQL con formato de salida vertical
- Entradas:
  - query (cadena): consulta SQL
  - params (objeto, opcional): parámetros de consulta
- Devuelve resultados en formato vertical limpio: GXP11
- Características:
  - Truncamiento inteligente de resultados grandes
  - Acceso al conjunto completo de resultados mediante la integración de claude-local-files
  - Visualización limpia de valores NULL
  - Fechas con formato ISO
  - Separación clara de filas

Archivos locales de Claude

Cuando claude-local-files está configurado:

Acceda a conjuntos de resultados completos más allá de la ventana de contexto de Claude
Generar informes y visualizaciones detallados
Realizar análisis profundos en grandes conjuntos de datos
Exportar resultados para su posterior procesamiento

La integración se activa automáticamente cuando se configura CLAUDE_LOCAL_FILES_PATH .

Desarrollo

Primero clona el repositorio de Github, instala las dependencias y los controladores de base de datos que elijas:

git clone git@github.com:runekaagaard/mcp-alchemy.git
cd mcp-alchemy
uv sync
uv pip install psycopg2-binary

Luego configure esto en claude_desktop_config.json:

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

Contribuyendo

¡Agradecemos cualquier contribución! Ya sean informes de errores, solicitudes de funciones, mejoras en la documentación o contribuciones de código, todas las aportaciones son valiosas. No dudes en:

Abra un problema para informar errores o sugerir funciones
Enviar solicitudes de extracción con mejoras
Mejore la documentación o comparta sus ejemplos de uso
Haz preguntas y comparte tus experiencias

El objetivo es hacer que la interacción de la base de datos con Claude sea aún mejor, y sus conocimientos y contribuciones ayudan a lograrlo.

Licencia

Licencia pública de Mozilla versión 2.0

Mis otros proyectos de LLM

MCP Redmine : deje que Claude Desktop administre sus proyectos y problemas de Redmine.
MCP Notmuch Sendmail - Asistente de correo electrónico para Claude Desktop que utiliza notmuch.
Diffpilot - Visor de diferencias Git de varias columnas con agrupación y etiquetado de archivos.
Archivos locales de Claude : acceda a archivos locales en los artefactos de Claude Desktop.

MCP Alchemy

Integrations