A Model Context Protocol server for interacting with MongoDB Atlas.

Developed using the official MCP SDK https://github.com/modelcontextprotocol/typescript-sdk

• 🚀 Getting Started
  • Prerequisites
  • Installation
  • Running the MCP Server
• 🔧 Troubleshooting
  • Restart Server
  • View Logs
  • Debugging
• 🛠️ Supported Tools
  • Tool List
• 👩‍💻 Client Integration
  • VSCode
  • Claude

• Node.js installed
• MongoDB Atlas account

npm install

npm run build

• Run npm run build to re-build the server if you made changes to the code
• Press Cmd + Shift + P and type List MCP Servers
• Select the MCP server you want to restart
• Select the option to restart the server

To see MCP logs, check https://code.visualstudio.com/docs/copilot/chat/mcp-servers.

• Press Cmd + Shift + P and type List MCP Servers
• Select the MCP server you want to see logs for
• Select the option to view logs in the output panel

We can use @modelcontextprotocol/inspector to debug the server - https://github.com/modelcontextprotocol/inspector

From the root of this repository, run:

npx @modelcontextprotocol/inspector -- node dist/index.js

Or use the npm script:

npm run inspect

• auth - Authenticate to MongoDB Atlas
• list-clusters - Lists MongoDB Atlas clusters
• list-projects - Lists MongoDB Atlas projects

Prerequisites:

• Use VSCode Insiders (https://code.visualstudio.com/insiders/)
• Setup copilot in VSCode Insiders

Step 1: Add the mcp server to VSCode configuration

• Press Cmd + Shift + P and type MCP: Add MCP Server and select it.
• Select the first option for a local MCP server.
• Add the path to dist/index.js in the prompt

Step 2: Verify the created mcp file

It should look like this

{ "servers": { "demo-atlas-server": { "type": "stdio", "command": "/Users/<user>/workplace/atlas-mcp-server/dist/index.js", "args": [] } } }

Step 3: Open the copilot chat and check that the toolbox icon is visible and has the mcp server listed.

Step 4: Try running a command

• Can you list my clusters?

Step 1: Install claude and login

brew install claude

Step 2: Create a configuration file for your MCP server

Open the file

code ~/Library/Application\ Support/Claude/claude_desktop_config.json 

Paste the mcp server configuration into the file

{ "mcpServers": { "Demo": { "command": "path/to/this/repo/atlas-mc-server/dist/index.js" } } } 

Step 3: Launch Claude Desktop and click on the hammer icon, the Demo MCP server should be detected. Type in the chat "show me a demo of MCP" and allow the tool to get access.

• Detailed instructions with screenshots can be found in this document.

Note: If you make changes to your MCP server code, rebuild the project with npm run build and restart the server and Claude Desktop.