mongo-list-collections
List all collections in a MongoDB database to view available data structures and organize database management tasks.
Instructions
List all collections in a MongoDB database
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| database | Yes | Database name |
Input Schema (JSON Schema)
{
"properties": {
"database": {
"description": "Database name",
"type": "string"
}
},
"required": [
"database"
],
"type": "object"
}
Implementation Reference
- src/index.ts:299-317 (handler)Handler function for the 'mongo-list-collections' tool. Connects to the MongoDB database, lists all collections using db.listCollections(), extracts collection names, and returns a formatted text response listing the collections.async ({ database: dbName }) => { try { const db = await ensureConnection(dbName); const collections = await db.listCollections().toArray(); const collectionNames = collections.map(col => col.name); return { content: [ { type: "text", text: `Collections in database '${dbName}':\n${collectionNames.join('\n')}`, }, ], }; } catch (error) { throw new Error(`Failed to list collections: ${error instanceof Error ? error.message : 'Unknown error'}`); } }
- src/index.ts:296-298 (schema)Input schema for the 'mongo-list-collections' tool, requiring a 'database' string parameter.{ database: z.string().describe("Database name"), },
- src/index.ts:293-318 (registration)Registration of the 'mongo-list-collections' tool on the MCP server, including name, description, schema, and handler function.server.tool( "mongo-list-collections", "List all collections in a MongoDB database", { database: z.string().describe("Database name"), }, async ({ database: dbName }) => { try { const db = await ensureConnection(dbName); const collections = await db.listCollections().toArray(); const collectionNames = collections.map(col => col.name); return { content: [ { type: "text", text: `Collections in database '${dbName}':\n${collectionNames.join('\n')}`, }, ], }; } catch (error) { throw new Error(`Failed to list collections: ${error instanceof Error ? error.message : 'Unknown error'}`); } } );
- src/index.ts:88-100 (helper)Helper function used by the tool to ensure a MongoDB client connection exists and returns the database instance for the given dbName.async function ensureConnection(dbName: string): Promise<Db> { if (!mongoClient) { const uri = getMongoUri(); mongoClient = new MongoClient(uri); await mongoClient.connect(); } if (!databases.has(dbName)) { databases.set(dbName, mongoClient.db(dbName)); } return databases.get(dbName)!; }