Skip to main content
Glama
jonfreeland

MongoDB MCP Server

by jonfreeland

MongoDB MCP 服务器

模型上下文协议服务器,通过标准化的 MCP 工具和资源提供对 MongoDB 数据库的只读访问。

概述

该 MongoDB MCP 服务器使 AI 助手能够直接查询和分析 MongoDB 数据库,而无需写入权限,在提供强大的数据探索功能的同时保证数据安全。

Related MCP server: MongoDB MCP Server for LLMs

特征

MongoDB 操作

  • 数据库探索:列出数据库和集合

  • 模式发现:从样本文档推断集合模式

  • 查询:使用过滤、投影、排序和限制执行 MongoDB 查询

  • 聚合:运行带有安全验证的只读聚合管道

  • 文本搜索:使用文本索引对集合进行全文搜索

  • 地理空间查询:查找点附近、多边形内或相交几何体的位置

  • 文档操作:计数文档、随机抽样文档、通过 ID 查找文档

  • 数据分析:获取集合统计信息、索引信息和查询执行计划

  • 性能洞察:检查查询执行计划以优化性能

  • 数据探索:获取不同的值、字段分布和数据样本

  • 格式转换:将查询结果导出为 JSON 或 CSV 格式

增强功能

  • 模式推断:自动从文档中检测数据类型和结构

  • 可视化提示:根据结果内容进行数据可视化的智能建议

  • 安全验证:防止聚合管道中的写入操作

  • 示例丰富的文档:每个工具在其描述中包含详细的示例

要求

环境变量

  • MONGODB_URI (必需):如果需要,带有身份验证的 MongoDB 连接字符串

  • MONGODB_DEFAULT_DATABASE (可选):查询中未指定时的默认数据库名称

先决条件

  • 通过网络访问 MongoDB 服务器

  • 如果 MongoDB 实例需要,则需要身份验证凭据

  • 对目标数据库的适当读取权限

安装

从源代码构建

安装依赖项:

npm install

构建服务器:

npm run build

对于使用自动重建的开发:

npm run watch

与 Claude Desktop 集成

要与 Claude Desktop 一起使用,请添加服务器配置:

在 MacOS 上: ~/Library/Application Support/Claude/claude_desktop_config.json在 Windows 上: %APPDATA%/Claude/claude_desktop_config.json

{ "mcpServers": { "mongodb": { "command": "/path/to/mongodb-server/build/index.js", "env": { "MONGODB_URI": "mongodb://username:password@hostname:port/database", "MONGODB_DEFAULT_DATABASE": "your_default_db" } } } }

与 Claude Web 集成

对于通过 MCP Chrome 扩展程序访问 Claude Web,将配置添加到 Cline MCP 设置:

{ "mcpServers": { "mongodb": { "command": "node", "args": ["/path/to/mongodb-server/build/index.js"], "env": { "MONGODB_URI": "mongodb://username:password@hostname:port/database", "MONGODB_DEFAULT_DATABASE": "your_default_db" } } } }

与 Claude Code 集成

要与 Claude Code 一起使用,请使用以下命令:

cd /path/to/my/project claude mcp add mongo-server /path/to/mongodb-mcp/build/index.js -e "MONGODB_URI=mongodb://user@password:27017/dbname?authSource=authDbName" -e MONGO_DEFAULT_DATABASE=dbname

确保用实际的 MongoDB 连接字符串和默认数据库名称替换占位符。

如果配置正确,运行claude时你应该会看到以下内容:

╭───────────────────────────────────────────────────────╮ │ ✻ Welcome to Claude Code research preview! │ │ │ │ /help for help │ │ │ │ cwd: <path-to-project-directory> │ │ │ │ ─────────────────────────────────────────────────── │ │ │ │ MCP Servers: │ │ │ │ • mongo-server connected │ ╰───────────────────────────────────────────────────────╯

如果遇到问题,请参阅 Claude 代码文档

安全注意事项

  • 该服务器设计提供只读访问权限

  • 连接字符串可能包含敏感的身份验证信息

  • 将连接字符串安全地存储在环境变量中

  • 使用具有只读权限的 MongoDB 用户

调试

由于 MCP 服务器通过 stdio 进行通信,调试起来可能比较困难。您可以使用MCP Inspector 工具,它包含在包脚本中:

npm run inspector

检查器将提供一个 URL 来访问浏览器中的调试工具。

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/jonfreeland/mongodb-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server