返回 MCP 目录
public公开dns本地运行

mongodb-lens

MongoDB Lens是一个本地MCP服务器,通过自然语言与LLM交互实现对MongoDB数据库的全面操作,包括查询、聚合、性能优化等。

article

README

🚀 MongoDB 突镜:中文教程与文档

MongoDB 突镜是一款实用工具,能帮助用户对 MongoDB 数据库进行操作,涵盖安装配置、数据库和文档管理等功能,还具备防护机制保障数据安全。

🚀 快速开始

本部分将指导你如何安装和配置 MongoDB 突镜,提供了本地安装、软件包安装(Node.js)和 Docker 部署三种方式。

本地安装

npm install -g mongodb-lens

软件包安装(Node.js)

npm install mongodb-lens

Docker 部署

FROM node:16

WORKDIR /app

COPY package.json ./

RUN npm install

COPY . .

CMD ["mongodb-lens"]

✨ 主要特性

MongoDB 突镜提供了一系列工具,涵盖数据库、文档、集合和资源操作,具体如下:

| 工具类别 | 工具名称 | 描述 | | -------------- | ---------------------------- | ------------------------------------------ | | 数据库工具 | create-database | 创建新数据库 | | | drop-database | 删除指定数据库 | | 集合工具 | create-collection | 创建新集合 | | | drop-collection | 删除指定集合 | | 文档工具 | find-documents | 查询文档 | | | insert-document | 插入单个文档 | | | insert-many | 批量插入文档 | | | update-document | 更新指定文档 | | | replace-document | 替换指定文档 | | | delete-document | 删除指定文档 | | 资源工具 | list-databases | 列出所有数据库 | | | list-collections | 列出当前数据库的所有集合 |

💻 使用示例

基础操作

数据库创建

"Create a new database named test_db"

文档插入

"Insert a single document into the users collection"
{
  "name": "John Doe",
  "email": "john@example.com"
}

确认保护机制操作

MongoDB 突镜针对破坏性操作提供了防护措施,以下是删除集合的操作示例:

  1. 请求删除集合:

    "Drop the collection named test_collection"
    
  2. 突镜弹出警告并生成确认码:

    ⚠️ 潜在危险操作警告 ⚠️
    
    您请求删除名为 'test_collection' 的集合。
    
    该操作不可逆,将永久删除所有数据。
    
    请输入以下确认码以继续:
    
    确认码:9876
    
    此代码将在5分钟后过期。
    
  3. 输入确认码:

    "9876"
    
  4. 执行操作并成功提示:

    集合 'test_collection' 已永久删除。
    

测试套件使用

MongoDB 突镜包含一个测试套件 mongodb-lens-test 用于验证功能。

安装测试套件

npm install mongodb-lens-test

运行测试

npx mongodb-lens-test

自定义测试

const { lens } = require('mongodb-lens');

describe('Database Operations', () => {
  it('should create a database', async () => {
    await expect(lens.createDatabase('test')).resolves.not.toThrow();
  });
});

📚 详细文档

常见问题解答

如何处理连接超时?

  • 检查网络状态
  • 确保 MongoDB 服务运行
  • 查看防火墙设置

如何提高性能?

  • 使用索引优化查询
  • 分片处理大数据集
  • 避免全表扫描

社区与支持

论坛

文档

提交问题

  • 发送邮件至 support@mongodb-lens.com

⚠️ 重要提示

在受控环境中,可通过配置绕过确认机制。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端