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

1. Clonar el repositorio:

2. Instalar dependencias:

3. Construya el código TypeScript:

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

Ventanas

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

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

1. Enumere todas las colecciones en su base de datos:

2. Obtener registros específicos de una colección:

3. Consulta con filtros:

4. Insertar un documento:

5. Eliminar un documento:

6. Datos agregados:

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