数据库访问MCP服务器

一个基于Java Spring的MCP服务器,通过MCP工具提供无缝的数据库访问和查询功能,使AI助手和其他MCP客户端能够使用结构化参数和查询与数据库交互。

  • by Mrunal-Shah7
  • Java
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 mrunal-shah7/adanidb-mcp

使用说明

基于MySQL的MCP服务器

基于Java Spring的模型上下文协议(MCP)服务器,通过MCP工具提供无缝的数据库访问和查询功能。此服务器使AI助手和其他MCP客户端能够使用结构化参数和查询与您的数据库进行交互。

概述

该项目使用Java Spring Boot实现了一个MCP服务器,该服务器充当MCP客户端(如Claude Desktop)和数据库之间的桥梁。服务器将数据库操作作为MCP工具公开,允许客户端:

  • 通过灵活的参数过滤从数据库表中获取数据
  • 使用多个输入参数执行结构化查询
  • 通过标准化的MCP接口访问数据库功能
  • 使用可配置参数维护安全的数据库连接

MCP(模型上下文协议)使AI助手能够以标准化的方式访问外部工具和资源。该服务器专门专注于数据库操作,使AI助手能够根据动态参数从数据库表中查询和检索数据。

先决条件

  • Java 17或更高版本
  • Maven 3.6或更高版本
  • 支持的数据库系统(MySQL、PostgreSQL等)
  • Claude Desktop或其他MCP客户端(用于测试和使用)

安装

1.克隆存储库

git clone https://github.com/mrunal-Shah7/AdaniDb-mcp.git
cd AdaniDB-mcp

2.数据库设置

配置数据库连接

在中编辑数据库连接参数 application.properties 文件位于:

src/main/resources/application.properties

使用数据库详细信息更新以下属性:

# Database Configuration
spring.datasource.url=jdbc:mysql://localhost:3306/your_database_name
spring.datasource.username=your_username
spring.datasource.password=your_password
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver

# JPA Configuration
spring.jpa.hibernate.ddl-auto=update
spring.jpa.show-sql=true
spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.MySQL8Dialect

创建数据库表(给定的sql文件仅适用于MySQL innoDB引擎)

使用根文件夹中的SQL文件创建必要的表:

mysql -u your_username -p your_database_name < database_schema.sql

3.建设项目

使用Maven构建JAR文件:

mvn clean package

编译后的JAR文件将位于 target/ 目录。

4.配置MCP客户端

如果您使用Claude Desktop作为MCP客户端,请编辑您的 claude_desktop_config.json 文件:

配置文件的位置:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • 视窗: %APPDATA%\Claude\claude_desktop_config.json

配置:

{
  "mcpServers": {
    "adaniDB-mcp": {
      "command": "java",
      "args": [
        "-jar",
        "/path/to/your/project/target/your-jar-file-name.jar"
      ],
      "env": {}
    }
  }
}

替换 /path/to/your/project/target/your-jar-file-name.jar 使用构建的JAR文件的实际路径。

用法

启动服务器

当Claude Desktop启动并检测到配置时,MCP服务器将自动启动。

可用的MCP工具

配置后,服务器将数据库操作作为MCP工具公开。可用的具体工具取决于您的实现,但通常包括:

  • 查询工具:对数据库表执行参数化查询

  • 数据检索工具:使用过滤和排序功能获取数据

  • 架构工具:访问表结构和元数据信息

  • 专为与Claude Desktop和其他MCP客户端集成而设计