SuperAPI AI 工具集

mcp-db-server-stateless

智能体与模型

查看项目

更新于 10-16 01:09

技能介绍

用途:mcp-db-server 是一个无状态 MCP(Model Context Protocol)服务,基于 Spring Boot 构建,让 AI 智能体直接与数据库交互。它不存储任何连接凭据,AI 客户端在每次请求时传入连接参数;服务端仅在内存中缓存连接池(默认 5 分钟 TTL),不做持久化。

支持的数据库:MySQL(3306)、PostgreSQL(5432)、H2(嵌入式)、SQLite(文件型)、SQL Server(1433)、Oracle(1521)。

主要能力(MCP 工具):listTables 列出表;describeTable 查看列信息;listIndexes 查看索引;executeQuery 执行只读 SQL(SELECT、SHOW、DESCRIBE、EXPLAIN,默认最多返回 100 行);executeUpdate 执行写操作(INSERT、UPDATE、DELETE、DDL);getDatabaseInfo 获取版本、驱动、能力等元数据。所有工具都要求每次调用传入 type、host、port、database、username、password 等连接参数。

使用方式:可用 Maven 运行(./mvnw spring-boot:run,Windows 用 .\mvnw.cmd spring-boot:run),或 Docker(docker build -t mcp-db-server . 后 docker run -d -p 8088:8088 --name mcp-db-server mcp-db-server,也可 docker-compose up -d),或构建 JAR(./mvnw clean package -DskipTests 后 java -jar target/mcp-db-server-1.0.0.jar,可用 --server.port=9090 改端口)。服务默认监听 http://localhost:8088,SSE 端点为 /sse。AI 客户端(如 Claude Desktop、Cursor)通过 SSE 配置连接该地址。

适用场景:数据库结构探索、数据分析查询、多库对比、受控的 schema 变更等。

限制与注意:需 Java 17+、Spring Boot 3.4.13、MCP 1.1.7;凭据不应硬编码,建议用环境变量;查询类操作建议使用只读账号;连接池大小与超时需按需调整;部分数据库驱动需自行添加依赖;Oracle 连接需使用正确的 JDBC URL 格式。项目为 PerfectXM/mcp-db-server,MIT 许可。具体收费、价格与平台信息暂未提供。