MCP-MongoDB-MySQL-Server

MCP-MongoDB-MySQL-Server

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

Overview

基本能力

产品定位

该服务是一个数据库操作中间件,为AI模型提供标准化的MySQL和MongoDB数据库操作接口。

核心功能

  • 支持MySQL和MongoDB数据库操作
  • 提供多种连接方式(URL、工作区路径、直接凭据)
  • 支持SQL查询执行(SELECT/INSERT/UPDATE/DELETE)
  • 支持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. 是的,MySQL查询支持预处理语句
  5. 如何确保安全性?
  6. 使用预处理语句防止SQL注入,通过环境变量管理敏感信息
  7. 是否支持TypeScript?
  8. 是的,项目提供TypeScript支持

使用教程

使用依赖

  • Node.js环境
  • MySQL/MongoDB数据库

安装教程

通过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. 填写以下字段:
    • 名称: mysql-mongodb
    • 类型: command
    • 命令: node /absolute/path/to/mcp-mongodb-mysql-server/build/index.js

调试方式

  1. 检查数据库连接是否成功
  2. 使用query/mongodb_find等工具测试基本查询
  3. 检查错误日志处理异常情况
  4. 验证预处理语句参数绑定是否正确

许可证

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