Servidor MCP de MongoDB

Un servidor de Protocolo de Contexto de Modelo que proporciona acceso de solo lectura a las bases de datos MongoDB. Este servidor permite a los LLM inspeccionar esquemas de colección y ejecutar pipelines de agregación.

Componentes

Herramientas

agregar
- Ejecutar canalizaciones de agregación de MongoDB contra la base de datos conectada
- Aporte:
  - collection (cadena): La colección a consultar
  - pipeline (matriz): etapas de la canalización de agregación de MongoDB
  - options (objeto): configuraciones de agregación opcionales
    - allowDiskUse (booleano): permitir operaciones que requieren el uso del disco
    - maxTimeMS (número): tiempo máximo de ejecución en milisegundos
    - comment (cadena): Comentario para identificar la operación
- Límite predeterminado de 1000 documentos si no se especifica ninguna etapa de límite
- Tiempo de espera predeterminado de 30 segundos
explicar
- Obtener planes de ejecución para pipelines de agregación
- Aporte:
  - collection (cadena): La colección a analizar
  - pipeline (matriz): etapas de la canalización de agregación de MongoDB
  - verbosity (cadena): Nivel de detalle de la explicación
    - Opciones: "queryPlanner", "executionStats", "allPlansExecution"
    - Valor predeterminado: "queryPlanner"

Recursos

El servidor proporciona información de esquema para cada colección en la base de datos:

Esquemas de colección ( mongodb://<host>/<collection>/schema )
- Información del esquema JSON inferida para cada colección
- Incluye nombres de campos y tipos de datos.
- El esquema se deriva de los documentos de recolección de muestras.

Related MCP server: MCP MySQL Server

Uso con Claude Desktop

Para usar este servidor con la aplicación Claude Desktop, agregue la siguiente configuración a la sección "mcpServers" de su claude_desktop_config.json :

"mongodb": { "command": "npx", "args": [ "-y" , "@pash1986/mcp-server-mongodb" ], "env" : { "MONGODB_URI" : "mongodb+srv://<yourcluster>" // 'mongodb://localhost:27017' } }

Reemplace mydb con el nombre de su base de datos y ajuste la cadena de conexión según sea necesario.

Ejemplo de uso

Agregación básica

{ "collection": "users", "pipeline": [ { "$match": { "age": { "$gt": 21 } } }, { "$group": { "_id": "$city", "avgAge": { "$avg": "$age" }, "count": { "$sum": 1 } }}, { "$sort": { "count": -1 } }, { "$limit": 10 } ], "options": { "allowDiskUse": true, "maxTimeMS": 60000, "comment": "City-wise user statistics" } }

Explicación de la consulta

{ "collection": "users", "pipeline": [ { "$match": { "age": { "$gt": 21 } } }, { "$sort": { "age": 1 } } ], "verbosity": "executionStats" }

Características de seguridad

Límite automático de 1000 documentos si no se especifica ningún límite en la canalización
Tiempo de espera predeterminado de 30 segundos para todas las operaciones
Solo operaciones de solo lectura
Inferencia de esquemas seguros a partir de muestras de colecciones

Licencia

Este servidor MCP cuenta con la licencia MIT. Esto significa que puede usar, modificar y distribuir el software libremente, sujeto a los términos y condiciones de la licencia MIT. Para más detalles, consulte el archivo de LICENCIA en el repositorio del proyecto.