MySQL MCP服务器与本地LLM查询工具

通过MySQL MCP服务器和本地LLM模型(如Ollama)或OpenAI兼容API查询MySQL数据库的工具,适用于开发者和数据分析师。

  • by RajiReddy-A
  • 本地部署
  • 更新于
在 GitHub 查看 rajireddy-a/mcp_mysql_local_llm

使用说明

通过MCP和本地LLM查询MySQL

本指南展示了如何:

  • 跑吧 MySQL MCP服务器 (@executeautomation/database-server)在Windows上
  • 安装和使用 MCP客户端CLI (llm 从 mcp-client-cli)与该服务器通信
  • 使用 局部Ollama模型 或 与OpenAI兼容的API

以下所有命令均适用于 Windows命令提示符(cmd.exe).


先决条件

  • Python 3.12+(64位) 已安装并位于PATH上
  • pipx 安装
  • Node.js 20+ 已安装(需要 npx 运行MCP服务器)
  • MySQL 使用数据库在本地运行 treedb 以及您可以使用的用户
  • (可选) 没有 如果您想要本地模型,请安装(例如:qwen3:8b)

验证基础知识

python --version
node --version
npm --version

安装pipx(如果你没有)

python -m pip install --user pipx
pipx ensurepath

关闭并重新打开终端,以便 %USERPROFILE%\.local\bin 在PATH上。


启动MySQL MCP服务器

打开 专用命令提示符 然后运行(保持打开状态):

npx -y @executeautomation/database-server --mysql --host localhost --database treedb --port 3306 --user colab --password colab123

您应该看到“MySQL连接已成功建立”和“正在启动MCP服务器…”等日志。


安装MCP客户端CLI(llm)

用管道安装:

pipx install mcp-client-cli==1.0.4 --python 3.12
pip install -r requirements.txt  # (or) pipx inject mcp-client-cli -r requirements.txt

检查一下 llm 在路径上:

llm --help

如果 llm 未找到,请确保 %USERPROFILE%\.local\bin 在你的 用户 PATH,然后打开 新 终端。

要查看pipx venv中安装了什么:

pipx list
pipx runpip mcp-client-cli show langgraph
pipx runpip mcp-client-cli show langgraph-prebuilt
pipx runpip mcp-client-cli show langgraph-sdk
pipx runpip mcp-client-cli show langgraph-checkpoint

使用本地 没有 模型

安装并启动Ollama,然后拉动一个模型(示例:Qwen 3 8B):

ollama run qwen3:8b

更新~/.llm/config.json

 {
     "systemPrompt": "You are a helpful assistant that can also use MCP tools.",
     "llm": {
         "provider": "openai",
         "model": "qwen3:8b",
         "base_url": "http://localhost:11434/v1",
         "api_key": "ollama",
         "temperature": 0.2
     },
     "mcpServers": {
         "mysql": {
             "command": "npx",
             "args": [
                 "-y",
                 "@executeautomation/database-server",
                 "--mysql",
                 "--host", "localhost",
                 "--database", "treedb",
                 "--port", "3306",
                 "--user", "colab",
                 "--password", "colab123"
             ]
         }
     }
 }

(可选)使用OPENAI API

将上面json中的llm部分替换为

 "llm": {
     "provider": "openai",
     "model": "gpt-4.1-mini",
     "api_key": "YOUR_OPENAI_API_KEY",
     "temperature": 0.2
 }

数据库查询示例

llm "Show the first 5 rows from the customers table in treedb."

覆盖config.json参数

llm --model qwen3:14b "Show the first 5 rows from the customers table in treedb."