Back to MCP directory
publicPublicdnsLocal runtime

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

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client