MongoDB MCP Server Windows 安装指南

前置要求

1. Node.js版本：≥20.19.0
2. MongoDB版本：≥4.2（必须！低于此版本无法连接）
3. Trae IDE或其他支持MCP的编辑器

安装步骤

第一步：下载MongoDB MCP Server

从GitHub下载压缩包解压到指定目录，例如：D:\local_mcp\mongodb-mcp-server-main

第二步：安装依赖并构建

进入项目目录并安装依赖：

cd /d D:\local_mcp\mongodb-mcp-server-main
npm install -g pnpm
pnpm install

构建项目：

pnpm run build

构建成功后，编译文件会在：dist\cjs\index.js

第三步：验证MongoDB版本

检查MongoDB版本是否≥4.2：

mongod --version

如果版本低于4.2，必须升级MongoDB，访问：https://www.mongodb.com/try/download/community

验证MongoDB是否运行：

tasklist | findstr mongod
netstat -ano | findstr :27017

第四步：配置MCP Server

在Trae IDE的MCP配置中添加：

{
  "mcpServers": {
    "mongodb": {
      "command": "node",
      "args": [
        "D:\\local_mcp\\mongodb-mcp-server-main\\dist\\cjs\\index.js"
      ],
      "env": {
        "MDB_MCP_CONNECTION_STRING": "mongodb://localhost:27017/test"
      }
    }
  }
}

第五步：创建日志目录

mkdir "%LOCALAPPDATA%\mongodb\mongodb-mcp\.app-logs"
icacls "%LOCALAPPDATA%\mongodb\mongodb-mcp\.app-logs" /grant %USERNAME%:(OI)(CI)F /T

第六步：重启IDE

保存配置，重启Trae IDE，查看MCP服务器状态（应该显示绿色勾勾）

第七步：验证安装

在AI对话中调用测试：

mcp_mongodb_list-databases()

成功则返回数据库列表。

连接字符串格式

本地MongoDB（无认证）：

mongodb://localhost:27017/database_name

本地MongoDB（有认证）：

mongodb://username:password@localhost:27017/database_name

MongoDB Atlas（云服务）：

mongodb+srv://username:password@cluster.mongodb.net/database_name

关键要点

1. ✅ Node.js版本≥20.19.0
2. ✅ MongoDB版本≥4.2（这是最关键的要求！）
3. ✅ 环境变量名称必须为：MDB_MCP_CONNECTION_STRING
4. ✅ 先安装pnpm再执行构建
5. ✅ 使用CMD命令执行