MongoDB MCP Server

Official

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Integrations

  • Provides read-only access to MongoDB databases, enabling inspection of collection schemas and execution of aggregation pipelines with safety features like document limits and query timeouts.

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.

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.

-
security - not tested
F
license - not found
-
quality - not tested

Proporciona acceso de solo lectura a las bases de datos MongoDB para que los LLM inspeccionen esquemas de recopilación y ejecuten canales de agregación.

  1. Components
    1. Tools
    2. Resources
  2. Usage with Claude Desktop
    1. Example Usage
      1. Basic Aggregation
      2. Query Explanation
    2. Safety Features
      1. License
        ID: 553iezfbrd