데이터 · MongoDB

MongoDB 설정

연결 문자열이나 Atlas service account를 사용해 MongoDB 데이터베이스와 Atlas 클러스터를 쿼리하고 관리합니다.

게시자: MongoDB 공식
로컬 실행: npx -y mongodb-mcp-server@latest --readOnly
전송 방식: stdio, streamable-http
인증: 연결 문자열, client ID와 secret이 있는 Atlas service account 또는 둘 다.
환경 변수: MDB_MCP_CONNECTION_STRINGMDB_MCP_API_CLIENT_IDMDB_MCP_API_CLIENT_SECRET
접근 가능한 항목: 읽기 및 쓰기. --readOnly를 사용하면 읽기만 가능합니다.
라이선스: Apache-2.0
소스: github.com/mongodb-js/mongodb-mcp-server
상태: 활성

설치

이 서버는 클라이언트의 자식 프로세스로 내 컴퓨터에서 실행됩니다. 명령에서 사용하는 런타임이 필요합니다. 예를 들어 npx에는 Node.js, uvx에는 uv, Docker에는 Docker가 필요합니다. Environment에 나열된 변수도 준비해야 합니다.

Claude Code

shell

claude mcp add --scope project --env MDB_MCP_CONNECTION_STRING='<MDB_MCP_CONNECTION_STRING>' --env MDB_MCP_API_CLIENT_ID='<MDB_MCP_API_CLIENT_ID>' --env MDB_MCP_API_CLIENT_SECRET='<MDB_MCP_API_CLIENT_SECRET>' mongodb -- npx -y mongodb-mcp-server@latest --readOnly

Cursor

.cursor/mcp.json

{
  "mcpServers": {
    "mongodb": {
      "command": "npx",
      "args": [
        "-y",
        "mongodb-mcp-server@latest",
        "--readOnly"
      ],
      "env": {
        "MDB_MCP_CONNECTION_STRING": "${env:MDB_MCP_CONNECTION_STRING}",
        "MDB_MCP_API_CLIENT_ID": "${env:MDB_MCP_API_CLIENT_ID}",
        "MDB_MCP_API_CLIENT_SECRET": "${env:MDB_MCP_API_CLIENT_SECRET}"
      }
    }
  }
}

Codex

~/.codex/config.toml

[mcp_servers.mongodb]
command = "npx"
args = ["-y", "mongodb-mcp-server@latest", "--readOnly"]
env_vars = ["MDB_MCP_CONNECTION_STRING", "MDB_MCP_API_CLIENT_ID", "MDB_MCP_API_CLIENT_SECRET"]

다른 클라이언트용 설정 →

생성된 명령에는 --readOnly가 유지됩니다. 에이전트가 쓰기 작업을 해야 할 때만 이 옵션을 제거하세요.