MCP-MongoDB-MySQL-Server

MCP-MongoDB-MySQL-Server

site icon
2025.03.09 6
JavaScript数据库中间件数据库操作AI数据库接口数据库
mcp-mongodb-mysql-server 是一个基于 Model Context Protocol 的服务器,提供 MySQL 和 MongoDB 数据库操作功能。该服务器使 AI 模型能够通过标准化接口与 MySQL 和 MongoDB 数据库交互。它是一个二次开发版本,在原项目仅支持 MySQL 的基础上添加了 MongoDB 支持,使其成为一个同时支持两种数据库的服务器。
View on GitHub

Overview

基本能力

产品定位

mcp-mongodb-mysql-server 是一个数据库操作中间件,旨在为 AI 模型提供标准化的数据库访问接口,支持 MySQL 和 MongoDB 两种主流数据库。

核心功能

  • 同时支持 MySQL 和 MongoDB 数据库操作
  • 提供多种数据库连接方式(URL、工作区路径、直接凭据)
  • 支持 MySQL 的 CRUD 操作和表结构管理
  • 支持 MongoDB 的文档操作和集合管理
  • 安全的连接处理和自动清理
  • 预处理语句支持防止 SQL 注入
  • 全面的错误处理和验证

适用场景

  • AI 模型需要访问数据库的应用场景
  • 需要同时操作 MySQL 和 MongoDB 的项目
  • 需要标准化数据库接口的开发环境
  • 数据库操作需要安全防护的场景

工具列表

MySQL工具

  1. connect_db: 连接到MySQL数据库
  2. query: 执行SELECT查询
  3. execute: 执行INSERT/UPDATE/DELETE操作
  4. list_tables: 列出所有表
  5. describe_table: 获取表结构
  6. create_table: 创建新表
  7. add_column: 添加列

MongoDB工具

  1. connect_mongodb: 连接到MongoDB
  2. mongodb_list_collections: 列出所有集合
  3. mongodb_find: 查找文档
  4. mongodb_insert: 插入文档
  5. mongodb_update: 更新文档
  6. mongodb_delete: 删除文档
  7. mongodb_create_collection: 创建新集合

常见问题解答

  1. 如何配置数据库连接?
  2. 通过.env文件配置
  3. 通过工具直接连接
  4. 如何防止SQL注入?
  5. 使用预处理语句
  6. 如何管理数据库连接?
  7. 服务器会自动关闭连接

使用教程

使用依赖

  • Node.js 环境
  • npm 包管理器

安装教程

通过Smithery安装

npx -y @smithery/cli install @yaoxiaolinglong/mcp-mongodb-mysql-server --client claude

手动安装

  1. 克隆并构建项目
git clone https://github.com/yaoxiaolinglong/mcp-mongodb-mysql-server.git
cd mcp-mongodb-mysql-server
npm install
npm run build
  1. 在Cursor IDE设置中添加服务器
  2. 打开命令面板(Cmd/Ctrl + Shift + P)
  3. 搜索"MCP: Add Server"
  4. 填写服务器信息

调试方式

  1. 检查数据库连接是否成功
  2. 测试基本查询功能
  3. 验证错误处理机制

数据库配置

MySQL配置

  1. 通过.env文件配置
DATABASE_URL=mysql://user:password@host:3306/database
  1. 通过工具直接连接
use_mcp_tool({
  server_name: "mysql-mongodb",
  tool_name: "connect_db",
  arguments: {
    url: "mysql://user:password@host:3306/database"
  }
});

MongoDB配置

  1. 通过.env文件配置
MONGODB_URI=mongodb://user:password@host:27017/database
MONGODB_DATABASE=your_database
  1. 通过工具直接连接
use_mcp_tool({
  server_name: "mysql-mongodb",
  tool_name: "connect_mongodb",
  arguments: {
    url: "mongodb://user:password@host:27017/database"
  }
});

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。