From 9f930a4ce2861b1fe8bf867780cfc54816bd415d Mon Sep 17 00:00:00 2001 From: Mohammod Al Amin Ashik Date: Wed, 11 Feb 2026 12:37:15 +0000 Subject: [PATCH 1/5] feat: add MongoDB MCP server definition Add MongoDB local stdio server via npx mongodb-mcp-server@latest. Query collections, inspect schemas, manage indexes, and run aggregation pipelines. Supports Atlas, Community, and Enterprise. https://claude.ai/code/session_013AxurW8hPAfnUNvik354Xx --- servers/com.mongodb-mcp.json | 65 ++++++++++++++++++++++++++++++++++++ 1 file changed, 65 insertions(+) create mode 100644 servers/com.mongodb-mcp.json diff --git a/servers/com.mongodb-mcp.json b/servers/com.mongodb-mcp.json new file mode 100644 index 0000000..10b32d4 --- /dev/null +++ b/servers/com.mongodb-mcp.json @@ -0,0 +1,65 @@ +{ + "$schema": "../schemas/server-definition.schema.json", + "id": "com.mongodb-mcp", + "name": "MongoDB", + "alias": "mongodb", + "description": "Connect to MongoDB databases and Atlas clusters. Query collections, inspect schemas, manage indexes, and run aggregation pipelines through the official MongoDB MCP server.", + "icon": "https://avatars.githubusercontent.com/u/11214950?v=4", + "schema_version": "2.1", + "categories": ["database"], + "tags": ["mongodb", "database", "nosql", "atlas", "aggregation", "collections", "documents"], + + "transport": { + "type": "stdio", + "command": "npx", + "args": ["-y", "mongodb-mcp-server@latest"], + "env": { + "MDB_MCP_CONNECTION_STRING": "${input:MONGODB_URI}" + }, + "metadata": { + "inputs": [ + { + "id": "MONGODB_URI", + "label": "MongoDB Connection String", + "description": "MongoDB connection URI for your database. Supports local instances, Atlas clusters, and replica sets.", + "type": "password", + "required": true, + "secret": true, + "placeholder": "mongodb+srv://username:password@cluster.mongodb.net/mydb", + "obtain": { + "url": "https://www.mongodb.com/docs/manual/reference/connection-string/", + "instructions": "1. For MongoDB Atlas: Go to your cluster > Connect > Drivers\n2. Copy the connection string\n3. Replace with your database password\n4. For local MongoDB: use mongodb://localhost:27017/mydb", + "button_label": "Learn More" + } + } + ] + } + }, + + "auth": { + "type": "none" + }, + + "contributor": { + "name": "MongoDB", + "github": "mongodb-js", + "url": "https://www.mongodb.com" + }, + + "links": { + "repository": "https://github.com/mongodb-js/mongodb-mcp-server", + "homepage": "https://www.mongodb.com", + "documentation": "https://www.mongodb.com/docs/mcp-server/get-started/" + }, + + "platforms": ["all"], + + "capabilities": { + "tools": true, + "resources": false, + "prompts": false, + "read_only_mode": false + }, + + "changelog_url": "https://github.com/mongodb-js/mongodb-mcp-server/releases" +} From 70c6db274d04a71f8181de022d2f78c97bb59b39 Mon Sep 17 00:00:00 2001 From: Mohammod Al Amin Ashik Date: Thu, 19 Feb 2026 19:09:54 +0800 Subject: [PATCH 2/5] fix: update server definition (input type 'password' -> 'text' for MONGODB_URI) --- servers/com.mongodb-mcp.json | 32 ++++++++++++++++++++------------ 1 file changed, 20 insertions(+), 12 deletions(-) diff --git a/servers/com.mongodb-mcp.json b/servers/com.mongodb-mcp.json index 10b32d4..0771f52 100644 --- a/servers/com.mongodb-mcp.json +++ b/servers/com.mongodb-mcp.json @@ -6,13 +6,25 @@ "description": "Connect to MongoDB databases and Atlas clusters. Query collections, inspect schemas, manage indexes, and run aggregation pipelines through the official MongoDB MCP server.", "icon": "https://avatars.githubusercontent.com/u/11214950?v=4", "schema_version": "2.1", - "categories": ["database"], - "tags": ["mongodb", "database", "nosql", "atlas", "aggregation", "collections", "documents"], - + "categories": [ + "database" + ], + "tags": [ + "mongodb", + "database", + "nosql", + "atlas", + "aggregation", + "collections", + "documents" + ], "transport": { "type": "stdio", "command": "npx", - "args": ["-y", "mongodb-mcp-server@latest"], + "args": [ + "-y", + "mongodb-mcp-server@latest" + ], "env": { "MDB_MCP_CONNECTION_STRING": "${input:MONGODB_URI}" }, @@ -22,7 +34,7 @@ "id": "MONGODB_URI", "label": "MongoDB Connection String", "description": "MongoDB connection URI for your database. Supports local instances, Atlas clusters, and replica sets.", - "type": "password", + "type": "text", "required": true, "secret": true, "placeholder": "mongodb+srv://username:password@cluster.mongodb.net/mydb", @@ -35,31 +47,27 @@ ] } }, - "auth": { "type": "none" }, - "contributor": { "name": "MongoDB", "github": "mongodb-js", "url": "https://www.mongodb.com" }, - "links": { "repository": "https://github.com/mongodb-js/mongodb-mcp-server", "homepage": "https://www.mongodb.com", "documentation": "https://www.mongodb.com/docs/mcp-server/get-started/" }, - - "platforms": ["all"], - + "platforms": [ + "all" + ], "capabilities": { "tools": true, "resources": false, "prompts": false, "read_only_mode": false }, - "changelog_url": "https://github.com/mongodb-js/mongodb-mcp-server/releases" } From 1c0d57f47f2f2d67c602908e33c38ad4fc1e9352 Mon Sep 17 00:00:00 2001 From: Mohammod Al Amin Ashik Date: Thu, 19 Feb 2026 20:15:08 +0800 Subject: [PATCH 3/5] feat(mongodb): add Atlas API inputs, Docker variant, read-only support - Add optional Atlas API Service Account credentials (client ID + secret) for Atlas management operations (cluster creation, user management, etc.) - Add Docker transport variant (com.mongodb-mcp-docker) using official mongodb/mongodb-mcp-server image - Make connection string optional (server supports runtime connect tool) - Update auth type to optional_api_key to reflect Atlas API credentials - Enable read_only_mode capability (server supports --readOnly flag) Signed-off-by: Mohammod Al Amin Ashik --- servers/com.mongodb-mcp-docker.json | 99 +++++++++++++++++++++++++++++ servers/com.mongodb-mcp.json | 41 ++++++++++-- 2 files changed, 135 insertions(+), 5 deletions(-) create mode 100644 servers/com.mongodb-mcp-docker.json diff --git a/servers/com.mongodb-mcp-docker.json b/servers/com.mongodb-mcp-docker.json new file mode 100644 index 0000000..b5f6067 --- /dev/null +++ b/servers/com.mongodb-mcp-docker.json @@ -0,0 +1,99 @@ +{ + "$schema": "../schemas/server-definition.schema.json", + "id": "com.mongodb-mcp-docker", + "name": "MongoDB (Docker)", + "alias": "mongodb-docker", + "description": "Connect to MongoDB databases and Atlas clusters via Docker. Query collections, inspect schemas, manage indexes, and run aggregation pipelines in an isolated container.", + "icon": "https://avatars.githubusercontent.com/u/11214950?v=4", + "schema_version": "2.1", + "categories": [ + "database" + ], + "tags": [ + "mongodb", + "database", + "nosql", + "atlas", + "docker", + "aggregation", + "collections" + ], + "transport": { + "type": "stdio", + "command": "docker", + "args": [ + "run", + "--rm", + "-i", + "-e", "MDB_MCP_CONNECTION_STRING", + "-e", "MDB_MCP_API_CLIENT_ID", + "-e", "MDB_MCP_API_CLIENT_SECRET", + "mongodb/mongodb-mcp-server:latest" + ], + "env": { + "MDB_MCP_CONNECTION_STRING": "${input:MONGODB_URI}", + "MDB_MCP_API_CLIENT_ID": "${input:ATLAS_CLIENT_ID}", + "MDB_MCP_API_CLIENT_SECRET": "${input:ATLAS_CLIENT_SECRET}" + }, + "metadata": { + "inputs": [ + { + "id": "MONGODB_URI", + "label": "MongoDB Connection String", + "description": "MongoDB connection URI. Use host.docker.internal instead of localhost for local instances (e.g., mongodb://host.docker.internal:27017/mydb).", + "type": "text", + "required": false, + "secret": true, + "placeholder": "mongodb+srv://username:password@cluster.mongodb.net/mydb", + "obtain": { + "url": "https://www.mongodb.com/docs/manual/reference/connection-string/", + "instructions": "1. For MongoDB Atlas: Go to your cluster > Connect > Drivers\n2. Copy the connection string\n3. For local MongoDB inside Docker: use mongodb://host.docker.internal:27017/mydb", + "button_label": "Learn More" + } + }, + { + "id": "ATLAS_CLIENT_ID", + "label": "Atlas API Client ID", + "description": "MongoDB Atlas Service Account client ID for Atlas management operations. Optional — only needed for Atlas administration.", + "type": "text", + "required": false, + "secret": true, + "placeholder": "mdb_sa_id_..." + }, + { + "id": "ATLAS_CLIENT_SECRET", + "label": "Atlas API Client Secret", + "description": "MongoDB Atlas Service Account client secret. Required when Atlas API Client ID is provided.", + "type": "text", + "required": false, + "secret": true, + "placeholder": "mdb_sa_sk_..." + } + ] + } + }, + "auth": { + "type": "optional_api_key", + "instructions": "Connection string provides database access. Atlas API credentials (optional) enable cluster management features." + }, + "contributor": { + "name": "MongoDB", + "github": "mongodb-js", + "url": "https://www.mongodb.com" + }, + "links": { + "repository": "https://github.com/mongodb-js/mongodb-mcp-server", + "homepage": "https://www.mongodb.com", + "documentation": "https://www.mongodb.com/docs/mcp-server/get-started/" + }, + "platforms": [ + "all" + ], + "capabilities": { + "tools": true, + "resources": false, + "prompts": false, + "read_only_mode": true + }, + "changelog_url": "https://github.com/mongodb-js/mongodb-mcp-server/releases" +} diff --git a/servers/com.mongodb-mcp.json b/servers/com.mongodb-mcp.json index 0771f52..63b6314 100644 --- a/servers/com.mongodb-mcp.json +++ b/servers/com.mongodb-mcp.json @@ -26,16 +26,18 @@ "mongodb-mcp-server@latest" ], "env": { - "MDB_MCP_CONNECTION_STRING": "${input:MONGODB_URI}" + "MDB_MCP_CONNECTION_STRING": "${input:MONGODB_URI}", + "MDB_MCP_API_CLIENT_ID": "${input:ATLAS_CLIENT_ID}", + "MDB_MCP_API_CLIENT_SECRET": "${input:ATLAS_CLIENT_SECRET}" }, "metadata": { "inputs": [ { "id": "MONGODB_URI", "label": "MongoDB Connection String", - "description": "MongoDB connection URI for your database. Supports local instances, Atlas clusters, and replica sets.", + "description": "MongoDB connection URI for your database. Supports local instances, Atlas clusters, and replica sets. Leave empty to use the runtime connect tool.", "type": "text", - "required": true, + "required": false, "secret": true, "placeholder": "mongodb+srv://username:password@cluster.mongodb.net/mydb", "obtain": { @@ -43,12 +45,41 @@ "instructions": "1. For MongoDB Atlas: Go to your cluster > Connect > Drivers\n2. Copy the connection string\n3. Replace with your database password\n4. For local MongoDB: use mongodb://localhost:27017/mydb", "button_label": "Learn More" } + }, + { + "id": "ATLAS_CLIENT_ID", + "label": "Atlas API Client ID", + "description": "MongoDB Atlas Service Account client ID for Atlas management operations (create clusters, manage users, IP access lists). Optional — only needed for Atlas administration.", + "type": "text", + "required": false, + "secret": true, + "placeholder": "mdb_sa_id_...", + "obtain": { + "url": "https://www.mongodb.com/docs/atlas/configure-api-access/", + "instructions": "1. Go to MongoDB Atlas > Organization Settings > Service Accounts\n2. Create a new Service Account with required roles\n3. Copy the Client ID", + "button_label": "Configure API Access" + } + }, + { + "id": "ATLAS_CLIENT_SECRET", + "label": "Atlas API Client Secret", + "description": "MongoDB Atlas Service Account client secret. Required when Atlas API Client ID is provided.", + "type": "text", + "required": false, + "secret": true, + "placeholder": "mdb_sa_sk_...", + "obtain": { + "url": "https://www.mongodb.com/docs/atlas/configure-api-access/", + "instructions": "1. Go to MongoDB Atlas > Organization Settings > Service Accounts\n2. Create or select a Service Account\n3. Copy the Client Secret (shown only once at creation)", + "button_label": "Configure API Access" + } } ] } }, "auth": { - "type": "none" + "type": "optional_api_key", + "instructions": "Connection string provides database access. Atlas API credentials (optional) enable cluster management features." }, "contributor": { "name": "MongoDB", @@ -67,7 +98,7 @@ "tools": true, "resources": false, "prompts": false, - "read_only_mode": false + "read_only_mode": true }, "changelog_url": "https://github.com/mongodb-js/mongodb-mcp-server/releases" } From d926104f338421d22083143a8ddeef370d4bfb1a Mon Sep 17 00:00:00 2001 From: Mohammod Al Amin Ashik Date: Thu, 19 Feb 2026 20:45:50 +0800 Subject: [PATCH 4/5] fix(mongodb): align input IDs with env var names MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Rename input IDs to match their corresponding environment variables: - MONGODB_URI → MDB_MCP_CONNECTION_STRING - ATLAS_CLIENT_ID → MDB_MCP_API_CLIENT_ID - ATLAS_CLIENT_SECRET → MDB_MCP_API_CLIENT_SECRET Signed-off-by: Mohammod Al Amin Ashik --- servers/com.mongodb-mcp-docker.json | 12 ++++++------ servers/com.mongodb-mcp.json | 12 ++++++------ 2 files changed, 12 insertions(+), 12 deletions(-) diff --git a/servers/com.mongodb-mcp-docker.json b/servers/com.mongodb-mcp-docker.json index b5f6067..f21142e 100644 --- a/servers/com.mongodb-mcp-docker.json +++ b/servers/com.mongodb-mcp-docker.json @@ -31,14 +31,14 @@ "mongodb/mongodb-mcp-server:latest" ], "env": { - "MDB_MCP_CONNECTION_STRING": "${input:MONGODB_URI}", - "MDB_MCP_API_CLIENT_ID": "${input:ATLAS_CLIENT_ID}", - "MDB_MCP_API_CLIENT_SECRET": "${input:ATLAS_CLIENT_SECRET}" + "MDB_MCP_CONNECTION_STRING": "${input:MDB_MCP_CONNECTION_STRING}", + "MDB_MCP_API_CLIENT_ID": "${input:MDB_MCP_API_CLIENT_ID}", + "MDB_MCP_API_CLIENT_SECRET": "${input:MDB_MCP_API_CLIENT_SECRET}" }, "metadata": { "inputs": [ { - "id": "MONGODB_URI", + "id": "MDB_MCP_CONNECTION_STRING", "label": "MongoDB Connection String", "description": "MongoDB connection URI. Use host.docker.internal instead of localhost for local instances (e.g., mongodb://host.docker.internal:27017/mydb).", "type": "text", @@ -52,7 +52,7 @@ } }, { - "id": "ATLAS_CLIENT_ID", + "id": "MDB_MCP_API_CLIENT_ID", "label": "Atlas API Client ID", "description": "MongoDB Atlas Service Account client ID for Atlas management operations. Optional — only needed for Atlas administration.", "type": "text", @@ -61,7 +61,7 @@ "placeholder": "mdb_sa_id_..." }, { - "id": "ATLAS_CLIENT_SECRET", + "id": "MDB_MCP_API_CLIENT_SECRET", "label": "Atlas API Client Secret", "description": "MongoDB Atlas Service Account client secret. Required when Atlas API Client ID is provided.", "type": "text", diff --git a/servers/com.mongodb-mcp.json b/servers/com.mongodb-mcp.json index 63b6314..e76608e 100644 --- a/servers/com.mongodb-mcp.json +++ b/servers/com.mongodb-mcp.json @@ -26,14 +26,14 @@ "mongodb-mcp-server@latest" ], "env": { - "MDB_MCP_CONNECTION_STRING": "${input:MONGODB_URI}", - "MDB_MCP_API_CLIENT_ID": "${input:ATLAS_CLIENT_ID}", - "MDB_MCP_API_CLIENT_SECRET": "${input:ATLAS_CLIENT_SECRET}" + "MDB_MCP_CONNECTION_STRING": "${input:MDB_MCP_CONNECTION_STRING}", + "MDB_MCP_API_CLIENT_ID": "${input:MDB_MCP_API_CLIENT_ID}", + "MDB_MCP_API_CLIENT_SECRET": "${input:MDB_MCP_API_CLIENT_SECRET}" }, "metadata": { "inputs": [ { - "id": "MONGODB_URI", + "id": "MDB_MCP_CONNECTION_STRING", "label": "MongoDB Connection String", "description": "MongoDB connection URI for your database. Supports local instances, Atlas clusters, and replica sets. Leave empty to use the runtime connect tool.", "type": "text", @@ -47,7 +47,7 @@ } }, { - "id": "ATLAS_CLIENT_ID", + "id": "MDB_MCP_API_CLIENT_ID", "label": "Atlas API Client ID", "description": "MongoDB Atlas Service Account client ID for Atlas management operations (create clusters, manage users, IP access lists). Optional — only needed for Atlas administration.", "type": "text", @@ -61,7 +61,7 @@ } }, { - "id": "ATLAS_CLIENT_SECRET", + "id": "MDB_MCP_API_CLIENT_SECRET", "label": "Atlas API Client Secret", "description": "MongoDB Atlas Service Account client secret. Required when Atlas API Client ID is provided.", "type": "text", From 663406b87f636ab7592e73c76c1ea8af2b50f42b Mon Sep 17 00:00:00 2001 From: Mohammod Al Amin Ashik Date: Thu, 19 Feb 2026 22:36:51 +0800 Subject: [PATCH 5/5] fix(mongodb): rename npx variant to com.mongodb-mcp-npx Align with naming convention used by other servers (e.g., sentry-mcp-npx, notion-mcp-npx). Renamed file and updated id/name fields. Signed-off-by: Mohammod Al Amin Ashik --- servers/{com.mongodb-mcp.json => com.mongodb-mcp-npx.json} | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) rename servers/{com.mongodb-mcp.json => com.mongodb-mcp-npx.json} (98%) diff --git a/servers/com.mongodb-mcp.json b/servers/com.mongodb-mcp-npx.json similarity index 98% rename from servers/com.mongodb-mcp.json rename to servers/com.mongodb-mcp-npx.json index e76608e..6d50879 100644 --- a/servers/com.mongodb-mcp.json +++ b/servers/com.mongodb-mcp-npx.json @@ -1,7 +1,7 @@ { "$schema": "../schemas/server-definition.schema.json", - "id": "com.mongodb-mcp", - "name": "MongoDB", + "id": "com.mongodb-mcp-npx", + "name": "MongoDB (npx)", "alias": "mongodb", "description": "Connect to MongoDB databases and Atlas clusters. Query collections, inspect schemas, manage indexes, and run aggregation pipelines through the official MongoDB MCP server.", "icon": "https://avatars.githubusercontent.com/u/11214950?v=4",