Smh Mongo MCP Server

SMH MongoDB服务器

一种模型上下文协议（MCP）服务器，使LLM能够与MongoDB数据库交互。该服务器提供通过标准化接口检查收集模式和执行MongoDB操作的功能。

视频演示


主要特点

智能对象ID处理

• 字符串ID和MongoDB ObjectId之间的智能转换

• 可配置 objectIdMode 参数：

- "auto"：根据字段名称转换（默认） - "none"：无转换 - "force"：强制所有字符串ID字段为ObjectId

灵活的配置

• 环境变量:

- MCP_MONGODB_URI：MongoDB连接URI - MCP_MONGODB_READONLY：设置为时启用只读模式 "true"

• 命令行选项:

- --read-only 或 -r：以只读模式连接

只读模式

• 防止写入操作（更新、插入、创建索引）
• 使用MongoDB的二次读取首选项以获得最佳性能
• 非常适合安全连接到生产数据库

MongoDB操作

• 读取操作:

- 查询具有可选执行计划分析的文档 - 执行聚合管道 - 统计符合条件的文档 - 获取集合架构信息

• 写入操作 （非只读模式时）：

- 更新文档 - 插入新文档 - 创建索引

LLM集成

• 收集完成以增强LLM交互
• 用于改进上下文理解的模式推理
• 数据洞察的收集分析

安装

全球安装

npm install -g smh-mongo-mcp-server

为了发展

# Clone repository
git clone https://github.com/smuniharish/smh-mongo-mcp-server.git
cd smh-mongo-mcp-server

# Install dependencies
npm install

# Build
npm run build

# Development with auto-rebuild
npm run watch

用法

基本用法

# Start server with MongoDB URI
npx -y smh-mongo-mcp-server mongodb://username:password@localhost:27017/database

# Connect in read-only mode
npx -y smh-mongo-mcp-server mongodb://username:password@localhost:27017/database --read-only

环境变量

# Set MongoDB connection URI
export MCP_MONGODB_URI="mongodb://username:password@localhost:27017/database"

# Enable read-only mode
export MCP_MONGODB_READONLY="true"

# Run server
npx -y smh-mongo-mcp-server

Claude桌面配置示例

{
  "mcpServers": {
    "mongodb-env": {
      "command": "npx",
      "args": [
        "-y",
        "smh-mongo-mcp-server"
      ],
      "env": {
        "MCP_MONGODB_URI": "mongodb://username:password@localhost:27017/database",
        "MCP_MONGODB_READONLY": "true"
      }
    }
  }
}

码头工人

# Build
docker build -t smh-mongo-mcp-server .

# Run
docker run -it -d -e MCP_MONGODB_URI="mongodb://username:password@localhost:27017/database" -e MCP_MONGODB_READONLY="true" smh-mongo-mcp-server

与Claude Desktop集成

手动配置

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json 视窗: %APPDATA%/Claude/claude_desktop_config.json

命令行参数

{
  "mcpServers": {
    "mongodb": {
      "command": "npx",
      "args": [
        "-y",
        "smh-mongo-mcp-server",
        "mongodb://username:password@localhost:27017/database"
      ]
    },
    "mongodb-readonly": {
      "command": "npx",
      "args": [
        "-y",
        "smh-mongo-mcp-server",
        "mongodb://username:password@localhost:27017/database",
        "--read-only"
      ]
    }
  }
}

GitHub包使用情况

{
  "mcpServers": {
    "mongodb": {
      "command": "npx",
      "args": [
        "-y",
        "github:smuniharish/smh-mongo-mcp-server",
        "mongodb://username:password@localhost:27017/database"
      ]
    }
  }
}

与Windsurf和Cursor集成

{
  "mcpServers": {
    "mongodb": {
      "command": "npx",
      "args": [
        "-y",
        "smh-mongo-mcp-server",
        "mongodb://username:password@localhost:27017/database"
      ]
    }
  }
}

可用工具

查询操作

• 怎么翻译
• 合计
• 计数

写入操作

• 插入
• 更新
• createIndex

系统操作

• list收藏
• 服务器信息

调试

使用MCP检查器：

npm run inspector

运行评估

OPENAI_API_KEY=your-key npx mcp-eval src/evals/evals.ts src/schemas/tools.ts

许可证

根据 Apache 2.0许可证。请参阅 许可证 文件以获取完整详细信息。