mysql-mcp-server-by-cdata

mysql-mcp-server-by-cdata

site icon
2025.05.02 0
Java数据库中间件自然语言查询数据库
mysql-mcp-server-by-cdata 是一个基于 CData JDBC Driver 的 Model Context Protocol (MCP) 服务器,专门为 MySQL 设计。它允许大型语言模型(如 Claude Desktop)通过自然语言查询实时 MySQL 数据,无需编写 SQL 语句。该服务器将 MySQL 数据作为关系型 SQL 模型暴露,并通过简单的 MCP 接口使数据可供 LLMs 使用。
View on GitHub

Overview

基本能力

产品定位

mysql-mcp-server-by-cdata 是一个中间件服务,旨在桥接 MySQL 数据库与大型语言模型(LLMs)之间的交互,使得 LLMs 能够通过自然语言查询实时 MySQL 数据。

核心功能

  1. 数据查询:支持通过自然语言查询 MySQL 数据,无需编写 SQL 语句。
  2. 工具集成:提供多种工具(如 get_tablesget_columnsrun_query)用于数据探索和查询。
  3. JDBC 驱动支持:基于 CData JDBC Driver,支持多种数据源的连接和查询。
  4. 只读访问:当前版本为只读模式,适合数据查询场景。

适用场景

  1. 数据分析:通过自然语言快速查询和分析 MySQL 数据。
  2. LLM 集成:为 LLMs 提供实时数据访问能力,增强其回答的准确性和实时性。
  3. 开发调试:开发者可以通过该服务快速验证数据查询逻辑。

工具列表

  1. {servername}_get_tables:获取数据源中可用的表列表。
  2. {servername}_get_columns:获取指定表的列信息。
  3. {servername}_run_query:执行 SQL SELECT 查询。

常见问题解答

  1. 无法在 Claude Desktop 中看到 MCP 服务器:确保完全退出并重新启动 Claude Desktop。
  2. 数据检索失败:检查连接字符串配置是否正确。
  3. 连接问题:使用 CData JDBC Driver 的连接字符串工具测试连接。
  4. 技术支持:联系 CData 支持团队或加入社区获取帮助。

使用教程

使用依赖

  1. 安装 Java 运行时环境(JRE)。
  2. 安装 Maven(用于构建项目)。

安装教程

  1. 克隆仓库: bash git clone https://github.com/cdatasoftware/mysql-mcp-server-by-cdata.git cd mysql-mcp-server-by-cdata
  2. 构建服务器: bash mvn clean install
  3. 下载并安装 CData JDBC Driver for MySQL:
  4. 访问 下载页面
  5. 配置 JDBC 连接:
  6. 运行 java -jar cdata.jdbc.mysql.jar 配置连接字符串。
  7. 创建 .prp 文件配置服务器参数。

调试方式

  1. 运行服务器: bash java -jar /PATH/TO/CDataMCP-jar-with-dependencies.jar /PATH/TO/mysql.prp
  2. 验证工具是否可用:
  3. 使用 {servername}_get_tables 检查表列表是否正常返回。
  4. 使用 {servername}_run_query 执行简单查询验证数据访问。

许可证

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