Universal Database MCP Server
使用说明(Markdown 格式)
-
项目简介
- 这是一个基于 MCP 的服务器实现,能够管理 SQLite、PostgreSQL、MySQL 和 MongoDB 等多种数据库,提供数据库创建、查询执行、数据导出、连接管理等功能。服务器通过 JSON-RPC 与 LLM 客户端进行通信,支持通过标准请求/响应模式进行工具调用和任务执行。
-
主要功能点
- MCP 核心能力:实现基于 MCP 的请求处理、工具注册与执行、响应封装,支持会话管理与能力声明。
- 多数据库支持:创建并管理 SQLite、PostgreSQL、MySQL、MongoDB 数据库及其数据结构。
- 数据操作工具:执行各数据库的查询、插入、更新、删除等操作,支持原生 SQL 与 MongoDB 操作。
- 数据导出与可视化:将表或查询结果导出为 CSV,列出表、导出所有表并提供简单预览。
- 连接管理与资源回收:维护各类型数据库连接,并提供清理、列出活动连接的能力。
- 管理工具对接:在合适场景下可打开对应的数据库管理工具(如 pgAdmin、MySQL Workbench、MongoDB Compass、SQLite 浏览器)。
- 简易的演示与调试支持:包含示例脚本与测试用例,便于快速验证 MCP 服务器的行为。
-
安装步骤
- 克隆仓库并进入项目目录
- 安装依赖:npm install
- 启动服务器:node server.js
-
服务器配置(MCP 客户端需要;以下为服务器端配置示例的描述)
- 服务器名称(server_name):database-mcp
- 启动命令(command):node
- 启动参数(args):server.js 注释:MCP 客户端需要知道服务器的名称、启动命令与参数来与 MCP 服务器建立连接。上述信息对应本仓库的服务器实现,通常以如下 JSON 形式描述(请以文本描述方式理解,该格式用于配置客户端连接,客户端本身并非必须展开为代码块): { "server_name": "database-mcp", "command": "node", "args": ["path/to/Database_MCP/server.js"] } 说明:在实际使用中,请将 path 替换为服务器实际的文件路径,例如在 Linux/macOS 系统上可能是 /home/你/Database_MCP/server.js,在 Windows 上可能是 C:\path\to\Database_MCP\server.js。
-
基本使用方法
- 运行后,LLM 客户端通过 MCP 协议发送请求,服务器返回 JSON-RPC 响应。
- 调用示例包括创建数据库、执行查询、导出数据、列出表、关闭连接等。
- 如需打开可视化工具,服务器会尝试调用相应的桌面应用(pgAdmin、MySQL Workbench、MongoDB Compass、SQLite 浏览器)以辅助管理。