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.5.2.210242",
"--refresh-package", "mcp-alchemy", "mcp-alchemy"],
"env": {
"DB_URL": "sqlite:////absolute/path/to/database.db"
}
}
}
}
PostgreSQL
{
"mcpServers": {
"my_postgres_db": {
"command": "uvx",
"args": ["--from", "mcp-alchemy==2025.5.2.210242", "--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.5.2.210242", "--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.5.2.210242", "--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.5.2.210242", "--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.5.2.210242", "--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 SQLparams (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"],
...
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.
Listados de directorios de MCP
MCP Alchemy aparece en los siguientes sitios de directorio y repositorios de MCP:
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