Integrations

Provides database operations through natural language for MongoDB, including listing collections, querying documents with filtering and projection, inserting documents, deleting documents, and executing aggregate pipeline operations.
Planned integration for PostgreSQL database operations, including SQL queries, table operations, and schema management.
Planned integration for Redis operations, including key-value operations, caching mechanisms, pub/sub functionality, and data structure operations.

Servidor de base de datos MCP

Implementación de servidor del Protocolo de Contexto de Modelo (MCP) que permite que los Modelos de Lenguaje Grandes (LLM) interactúen con diversas bases de datos mediante lenguaje natural. Actualmente es compatible con MongoDB y se prevé que también lo sea:

PostgreSQL
Base de datos de cucarachas
Redis
Y más...

Características

Operaciones de bases de datos mediante lenguaje natural
Actualmente es compatible con MongoDB con las siguientes características:
- Listar todas las colecciones
- Consultar documentos con filtrado y proyección
- Insertar documentos
- Eliminar documentos
- Operaciones de tuberías de agregados
Soporte futuro para otras bases de datos:
- PostgreSQL: consultas SQL, operaciones de tabla
- CockroachDB: Operaciones SQL distribuidas
- Redis: Operaciones clave-valor, almacenamiento en caché

Prerrequisitos

Node.js v20.12.2 o superior
Base de datos (actualmente MongoDB, próximamente se añadirán otras bases de datos)
Aplicación de escritorio Claude

Instalación

Clonar el repositorio:

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

Instalar dependencias:

npm install

Construya el código TypeScript:

npm run build

Configuración

Para comenzar, debe configurar su conexión de base de datos en el archivo de configuración de Claude Desktop:

Sistema operativo Mac

~/Library/Application\ Support/Claude/claude_desktop_config.json

Ventanas

%APPDATA%/Claude/claude_desktop_config.json

Agregue la siguiente configuración a su claude_desktop_config.json :

{
  "mcpServers": {
    "database": {
      "command": "/path/to/node",
      "args": ["/path/to/mcp-database/dist/index.js"],
      "env": {
        "MONGODB_URI": "your-mongodb-connection-string"
      }
    }
  }
}

Reemplazar:

/path/to/node con su ruta ejecutable Node.js o simplemente use node
/path/to/mcp-database con la ruta absoluta a este repositorio
your-mongodb-connection-string con la URL de su conexión MongoDB

Ejemplos de uso

Ejemplos de MongoDB

Enumere todas las colecciones en su base de datos:

Can you show me all the collections in my database?

Obtener registros específicos de una colección:

Give me 2 records from the chargers collection

Consulta con filtros:

Show me all documents in the users collection where status is active

Insertar un documento:

Add a new user to the users collection with name John and email john@example.com

Eliminar un documento:

Remove the user with email john@example.com from the users collection

Datos agregados:

Show me the total count of users by status in the users collection

Herramientas disponibles

1. obtener colecciones

Enumera todas las colecciones en la base de datos conectada.

2. obtenerColección

Recupera documentos de una colección con parámetros de consulta opcionales:

collectionName : Nombre de la colección
limit : Número máximo de documentos a devolver (predeterminado: 10, máximo: 1000)
query : objeto de consulta de MongoDB
projection : Campos a incluir/excluir

3. insertOne

Inserta un solo documento en una colección:

collectionName : Nombre de la colección
document : Objeto de documento a insertar

4. deleteOne

Elimina un solo documento de una colección:

collectionName : Nombre de la colección
query : Consulta para que coincida con el documento a eliminar

5. agregado

Ejecuta una canalización de agregación:

collectionName : Nombre de la colección
pipeline : Matriz de etapas de agregación
options : Opciones de agregación opcionales

Soporte de bases de datos futuras

PostgreSQL

Ejecución de consultas SQL
Operaciones de tabla
Gestión de esquemas
Soporte para transacciones

Base de datos de cucarachas

Operaciones SQL distribuidas
Soporte multirregional
Gestión de transacciones
Operaciones de esquema

Redis

Operaciones clave-valor
Mecanismos de almacenamiento en caché
Operaciones de pub/suscripción
Operaciones de estructura de datos

Seguridad

Nunca envíe sus cadenas de conexión de base de datos al control de versiones
Utilice variables de entorno para información confidencial
Siga las mejores prácticas de seguridad específicas de la base de datos

Contribuyendo

¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios. Para cambios importantes, primero abra una incidencia para comentar qué desea cambiar.

Licencia

Licencia MIT: consulte LICENCIA para obtener más detalles

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

Un servidor de protocolo de contexto de modelo que permite a los LLM interactuar con bases de datos (actualmente MongoDB) a través del lenguaje natural, admitiendo operaciones como consultas, inserciones, eliminaciones de documentos y ejecución de canales de agregación.

MCP Database Server