Servidor de base de datos MCP

Este servidor MCP (Protocolo de contexto de modelo) proporciona capacidades de acceso a bases de datos a Claude y admite bases de datos SQLite, SQL Server y PostgreSQL.

Instalación

1. Clonar el repositorio:

git clone https://github.com/executeautomation/database-server.git
cd database-server

2. Instalar dependencias:

npm install

3. Construir el proyecto:

npm run build

Related MCP server: MCP SQL Server

Opciones de uso

Hay dos formas de utilizar este servidor MCP con Claude:

1. Uso directo : instala el paquete globalmente y úsalo directamente

2. Desarrollo local : Ejecute desde su entorno de desarrollo local

Uso directo con el paquete NPM

La forma más sencilla de utilizar este servidor MCP es instalándolo globalmente:

npm install -g @executeautomation/database-server

Esto le permite utilizar el servidor directamente sin construirlo localmente.

Configuración de desarrollo local

Si desea modificar el código o ejecutarlo desde su entorno local:

1. Clone y construya el repositorio como se muestra en la sección Instalación

2. Ejecute el servidor utilizando los comandos en la sección Uso a continuación

Uso

Base de datos SQLite

Para utilizar con una base de datos SQLite:

node dist/src/index.js /path/to/your/database.db

Base de datos de SQL Server

Para utilizar con una base de datos de SQL Server:

node dist/src/index.js --sqlserver --server <server-name> --database <database-name> [--user <username> --password <password>]

Parámetros requeridos:

• --server : nombre de host o dirección IP de SQL Server

• --database : Nombre de la base de datos

Parámetros opcionales:

• --user : Nombre de usuario para la autenticación de SQL Server (si no se proporciona, se utilizará la autenticación de Windows)

• --password : Contraseña para la autenticación de SQL Server

• --port : Número de puerto (predeterminado: 1433)

Base de datos PostgreSQL

Para utilizar con una base de datos PostgreSQL:

node dist/src/index.js --postgresql --host <host-name> --database <database-name> [--user <username> --password <password>]

Parámetros requeridos:

• --host : nombre de host o dirección IP de PostgreSQL

• --database : Nombre de la base de datos

Parámetros opcionales:

• --user : Nombre de usuario para la autenticación de PostgreSQL

• --password : Contraseña para la autenticación de PostgreSQL

• --port : Número de puerto (predeterminado: 5432)

• --ssl : Habilitar la conexión SSL (verdadero/falso)

• --connection-timeout : Tiempo de espera de conexión en milisegundos (predeterminado: 30000)

Configuración de Claude Desktop

Configuración de uso directo

Si instaló el paquete globalmente, configure Claude Desktop con:

{
  "mcpServers": {
    "sqlite": {
      "command": "npx",
      "args": [
        "-y",
        "@executeautomation/database-server",
        "/path/to/your/database.db"
      ]
    },
    "sqlserver": {
      "command": "npx",
      "args": [
        "-y",
        "@executeautomation/database-server",
        "--sqlserver",
        "--server", "your-server-name",
        "--database", "your-database-name",
        "--user", "your-username",
        "--password", "your-password"
      ]
    },
    "postgresql": {
      "command": "npx",
      "args": [
        "-y",
        "@executeautomation/database-server",
        "--postgresql",
        "--host", "your-host-name",
        "--database", "your-database-name",
        "--user", "your-username",
        "--password", "your-password"
      ]
    }
  }
}

Configuración de desarrollo local

Para el desarrollo local, configure Claude Desktop para utilizar su versión creada localmente:

{
  "mcpServers": {
    "sqlite": {
      "command": "node",
      "args": [
        "/absolute/path/to/mcp-database-server/dist/src/index.js", 
        "/path/to/your/database.db"
      ]
    },
    "sqlserver": {
      "command": "node",
      "args": [
        "/absolute/path/to/mcp-database-server/dist/src/index.js",
        "--sqlserver",
        "--server", "your-server-name",
        "--database", "your-database-name",
        "--user", "your-username",
        "--password", "your-password"
      ]
    },
    "postgresql": {
      "command": "node",
      "args": [
        "/absolute/path/to/mcp-database-server/dist/src/index.js",
        "--postgresql",
        "--host", "your-host-name",
        "--database", "your-database-name",
        "--user", "your-username",
        "--password", "your-password"
      ]
    }
  }
}

El archivo de configuración de Claude Desktop normalmente se encuentra en:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Ventanas: %APPDATA%\Claude\claude_desktop_config.json

• Linux: ~/.config/Claude/claude_desktop_config.json

Herramientas de base de datos disponibles

El servidor de base de datos MCP proporciona las siguientes herramientas que Claude puede utilizar:

Para obtener ejemplos prácticos de cómo utilizar estas herramientas con Claude, consulte Ejemplos de uso .

Documentación adicional

• Guía de configuración de SQL Server : detalles sobre cómo conectarse a bases de datos de SQL Server

• Guía de configuración de PostgreSQL : detalles sobre cómo conectarse a bases de datos PostgreSQL

• Ejemplos de uso : Ejemplos de consultas y comandos para usar con Claude

Desarrollo

Para ejecutar el servidor en modo de desarrollo:

npm run dev

Para observar los cambios durante el desarrollo:

npm run watch

Requisitos

• Node.js 18+

• Para la conectividad de SQL Server: SQL Server 2012 o posterior

• Para conectividad PostgreSQL: PostgreSQL 9.5 o posterior

Licencia

Instituto Tecnológico de Massachusetts (MIT)