项目简介
AI to MySQL MCP Server (ai2mysql-mcp-server) 是一个基于 go-mcp 框架实现的 Model Context Protocol (MCP) 服务器,专注于提供 MySQL 数据库连接和操作能力。它允许 LLM 客户端通过 MCP 协议与 MySQL 数据库进行交互,执行 SQL 查询、数据插入、更新等操作,从而扩展 LLM 的数据访问能力。
主要功能点
- MCP 协议支持:遵循 Model Context Protocol 协议,可以与任何兼容 MCP 协议的 LLM 客户端进行通信。
- MySQL 数据库连接:提供连接 MySQL 数据库的能力,允许 LLM 应用访问和操作 MySQL 数据库中的数据。
- SQL 查询执行:支持执行 SQL 查询语句,并将查询结果返回给 LLM 客户端。
- 数据操作:支持执行数据操作语句,如 INSERT、UPDATE、DELETE 等,允许 LLM 应用修改数据库中的数据。
- Stdio 传输协议:通过标准输入输出 (stdio) 与 LLM 客户端进行通信,部署简单方便。
安装步骤
- 安装 Go 语言环境:确保你的开发环境中已安装 Go 语言。你可以从 Go 官网 下载并安装。
- 克隆仓库:使用 Git 克隆 ai2mysql-mcp-server 仓库到本地:
git clone https://github.com/blanplan-ai/ai2mysql-mcp-server - 进入仓库目录:
cd ai2mysql-mcp-server - 构建服务器程序:使用 'go build' 命令编译服务器程序:
构建成功后,会在当前目录下生成可执行文件 'ai2mysql-mcp-server' (Linux/macOS) 或 'ai2mysql-mcp-server.exe' (Windows)。go build -o ai2mysql-mcp-server
服务器配置
MCP 客户端需要配置服务器的启动命令和参数才能连接 ai2mysql-mcp-server。以下是一个典型的 JSON 格式配置示例,你需要将其配置到你的 MCP 客户端中:
{ "serverName": "ai2mysql-mcp-server", "command": "./ai2mysql-mcp-server", "args": [], "description": "AI to MySQL MCP Server 提供 MySQL 数据库连接服务。" }
- serverName: 服务器的名称,可以自定义,用于在客户端标识不同的 MCP 服务器。
- command: 启动 ai2mysql-mcp-server 服务器的可执行文件路径。如果你的客户端和服务器在同一目录下,可以使用 './ai2mysql-mcp-server' (Linux/macOS) 或 '.\ai2mysql-mcp-server.exe' (Windows)。请根据实际情况修改路径。
- args: 启动服务器时需要传递的命令行参数。本服务器默认不需要额外的参数,所以设置为空数组 '[]'。
- description: 服务器的描述信息,用于在客户端界面展示,方便用户了解服务器的功能。
基本使用方法
-
启动服务器:在 ai2mysql-mcp-server 仓库目录下,运行编译生成的可执行文件启动服务器:
./ai2mysql-mcp-server服务器启动后,将监听来自 MCP 客户端的请求。
-
配置 MCP 客户端:在你的 LLM 应用或 MCP 客户端中,按照其文档说明配置 MCP 服务器连接信息,使用上面提供的 JSON 配置示例。确保客户端能够通过 stdio 与 ai2mysql-mcp-server 服务器进行通信。
-
通过客户端调用工具: LLM 客户端通过 MCP 协议向 ai2mysql-mcp-server 发送请求,调用服务器提供的工具 (Tool) 来执行 SQL 查询和数据操作。具体的工具名称、参数和使用方法需要参考 ai2mysql-mcp-server 的代码或相关文档(如果提供)。一般来说,客户端可以使用类似 "Tool.Invoke" 的 MCP 方法调用服务器提供的数据库操作工具。
请注意,本使用说明基于仓库提供的有限信息进行推断,更详细的使用方法和工具调用方式可能需要查阅 ai2mysql-mcp-server 仓库的代码或作者提供的文档。
信息
分类
数据库与文件