Skip to main content
Glama
mysql_mcp_server

mysql_mcp_server

by wenb1n-dev

简体中文 Английский

mcp_mysql_server

Введение

mcp_mysql_server_pro не только поддерживает операции MySQL CRUD, но также включает в себя возможности анализа аномалий базы данных и позволяет разработчикам легко расширять возможности с помощью специальных инструментов.

  • Поддерживает режимы STDIO и SSE

  • Поддерживает многократное выполнение SQL, разделенное символом «;»

  • Поддерживает запросы имен таблиц и полей базы данных на основе комментариев к таблицам.

  • Поддерживает анализ плана выполнения SQL

  • Поддерживает преобразование китайского поля в пиньинь

  • Поддерживает анализ блокировки таблиц

  • Поддерживает анализ состояния работоспособности базы данных

  • Поддерживает управление разрешениями с тремя ролями: только чтение, запись и администратор

    "readonly": ["SELECT", "SHOW", "DESCRIBE", "EXPLAIN"],  # Read-only permissions
    "writer": ["SELECT", "SHOW", "DESCRIBE", "EXPLAIN", "INSERT", "UPDATE", "DELETE"],  # Read-write permissions
    "admin": ["SELECT", "SHOW", "DESCRIBE", "EXPLAIN", "INSERT", "UPDATE", "DELETE", 
             "CREATE", "ALTER", "DROP", "TRUNCATE"]  # Administrator permissions
  • Поддерживает вызов шаблона подсказки

Related MCP server: MySQL MCP Server Pro

Список инструментов

Название инструмента

Описание

выполнить_sql

Инструмент выполнения SQL, который может выполнять команды ["SELECT", "SHOW", "DESCRIBE", "EXPLAIN", "INSERT", "UPDATE", "DELETE", "CREATE", "ALTER", "DROP", "TRUNCATE"] на основе конфигурации разрешений

получить_китайские_инициалы

Преобразовать китайские названия полей в инициалы пиньинь

get_db_health_running

Анализ состояния работоспособности MySQL (состояние соединения, состояние транзакции, состояние выполнения, обнаружение состояния блокировки)

получить_таблицу_описание

Поиск структур таблиц в базе данных на основе имен таблиц, поддержка многотабличных запросов

получить_табличный_индекс

Поиск индексов таблиц в базе данных на основе имен таблиц, поддержка многотабличных запросов

получить_таблицу_блокировку

Проверьте, есть ли блокировки на уровне строк или таблиц на текущем сервере MySQL.

получить_имя_таблицы

Поиск названий таблиц в базе данных на основе комментариев и описаний таблиц.

get_db_health_index_usage

Получите данные об использовании индекса текущей подключенной базы данных MySQL, включая ситуации с избыточными индексами, ситуации с неэффективной работой индексов и 5 основных неиспользуемых ситуаций с индексами, время запроса которых превышает 30 секунд.

Список подсказок

Имя подсказки

Описание

анализ-mysql-prompt

Это подсказка для анализа проблем, связанных с MySQL.

запрос-таблица-данных-подсказка

Это приглашение для запроса табличных данных с помощью инструментов. Если описание пустое, оно будет инициализировано как помощник по запросам базы данных MySQL

Инструкция по применению

Режим SSE

  • Используйте uv для запуска службы

Добавьте следующий контент в инструменты клиента mcp, например, cursor, cline и т. д.

mcp json следующим образом:

{
  "mcpServers": {
    "operateMysql": {
      "name": "operateMysql",
      "description": "",
      "isActive": true,
      "baseUrl": "http://localhost:9000/sse"
    }
  }
}

Измените содержимое файла .env, чтобы обновить информацию о подключении к базе данных, указав сведения о вашей базе данных:

# MySQL Database Configuration
MYSQL_HOST=192.168.xxx.xxx
MYSQL_PORT=3306
MYSQL_USER=root
MYSQL_PASSWORD=root
MYSQL_DATABASE=a_llm
MYSQL_ROLE=readonly  # Optional, default is 'readonly'. Available values: readonly, writer, admin

Команды запуска:

# Download dependencies
uv sync

# Start
uv run server.py

Режим STDIO

Добавьте следующий контент в инструменты клиента mcp, например, cursor, cline и т. д.

mcp json следующим образом:

{
  "mcpServers": {
      "operateMysql": {
        "isActive": true,
        "name": "operateMysql",
        "command": "uv",
        "args": [
          "--directory",
          "G:\\python\\mysql_mcp\\src",  # Replace this with your project path
          "run",
          "server.py",
          "--stdio"
        ],
        "env": {
          "MYSQL_HOST": "192.168.xxx.xxx",
          "MYSQL_PORT": "3306",
          "MYSQL_USER": "root",
          "MYSQL_PASSWORD": "root",
          "MYSQL_DATABASE": "a_llm",
          "MYSQL_ROLE": "readonly"  # Optional, default is 'readonly'. Available values: readonly, writer, admin
       }
    }
  }
}    

Расширения для пользовательских инструментов

  1. Добавьте новый класс инструмента в пакет handles, унаследуйте его от BaseHandler и реализуйте методы get_tool_description и run_tool.

  2. Импортируйте новый инструмент в init .py, чтобы сделать его доступным на сервере.

Примеры

  1. Создайте новую таблицу и вставьте данные, формат запроса должен быть следующим:

# Task
   Create an organizational structure table with the following structure: department name, department number, parent department, is valid.
# Requirements
 - Table name: department
 - Common fields need indexes
 - Each field needs comments, table needs comment
 - Generate 5 real data records after creation

изображениеизображение

  1. Запрос данных на основе комментариев к таблице, выполнив следующий запрос:

Search for data with Department name 'Executive Office' in Department organizational structure table

изображение

  1. Проанализируйте медленный SQL, запросив следующее:

select * from t_jcsjzx_hjkq_cd_xsz_sk xsz
left join t_jcsjzx_hjkq_jcd jcd on jcd.cddm = xsz.cddm 
Based on current index situation, review execution plan and provide optimization suggestions in markdown format, including table index status, execution details, and optimization recommendations
  1. Проанализируйте проблемы взаимоблокировки SQL, выполнив следующие действия:

update t_admin_rms_zzjg set sfyx = '0' where xh = '1' is stuck, please analyze the cause
  1. Проанализируйте запрос о состоянии здоровья следующим образом:

Check the current health status of MySQL

изображение

Available Tools

5 tools
execute_sqlC

在MySQL5.6s数据库上执行SQL

Inputs: query (required).

get_chinese_initialsB

创建表结构时,将中文字段名转换为拼音首字母字段

Inputs: text (required).

get_table_descC

根据表名搜索数据库中对应的表结构,支持多表查询

Inputs: text (required).

get_table_indexC

根据表名搜索数据库中对应的表索引,支持多表查询

Inputs: text (required).

get_table_nameB

根据表中文名搜索数据库中对应的表名

Inputs: text (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.1/5.0

    Scored across 5 tools

    Disambiguation3/5

    The tools have distinct primary purposes (SQL execution, field name conversion, table structure/index/name retrieval), but there is some overlap between get_table_desc, get_table_index, and get_table_name as they all involve table metadata retrieval, which could cause confusion about which to use for specific queries. Descriptions help clarify, but the boundaries are not perfectly clear.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern using snake_case (e.g., execute_sql, get_table_desc), with no deviations in style or convention. This predictability makes it easy for agents to understand and navigate the tool set.

    Tool Count4/5

    With 5 tools, the count is reasonable and well-scoped for a MySQL server, covering core operations like SQL execution and table metadata access. It is slightly lean but not insufficient, as it avoids bloat while providing essential functionality.

    Completeness2/5

    The tool set is severely incomplete for a MySQL database server. It lacks basic CRUD operations (e.g., create_table, update_data, delete_table), data manipulation beyond raw SQL, and lifecycle management tools, leaving significant gaps that will hinder agent workflows and cause failures in typical database interactions.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      A universal SQLite database management tool that enables SQL query execution through MCP protocol. Supports SELECT/INSERT/UPDATE/DELETE/CREATE operations with built-in SQL injection protection across stdio, SSE, and streamable-http communication modes.
      MIT
    • A
      license
      B
      quality
      D
      maintenance
      Provides comprehensive MySQL database operations including CRUD, performance optimization, health analysis, and anomaly detection. Supports multiple connection modes, OAuth2.0 authentication, and role-based permissions for database management through natural language.
      9
      1
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Multi-database management tool and MCP server supporting MySQL, PostgreSQL, SQLite, and Dameng DM8, enabling AI assistants to query and manage databases via stdio or HTTP.
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables SQL queries, schema exploration, and Oracle sequence management across multiple databases including Oracle, OceanBase, and DolphinDB. Supports multiple environments with secure password handling.
      -