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: legacy-mongodb-mcp

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.