mysqltuner MCP

MySQL性能调优MCP

](https://pypi.org/project/mysqltuner-mcp/) ](https://pypi.org/project/mysqltuner-mcp/)  ](https://pypi.org/project/mysqltuner-mcp/) ](https://hub.docker.com/r/dog830228/mysqltuner_mcp)

用于MySQL性能调优和分析的模型上下文协议（MCP）服务器。

概述

mysqltuner_mcp 通过模型上下文协议提供人工智能驱动的MySQL数据库性能分析。它提供了查询优化、索引推荐、健康监测等工具

特性

性能分析

• 慢速查询检测：从performance_schema中识别慢速查询
• 查询分析：获取详细的解释计划和建议
• 表统计：分析表大小、行数和碎片
• 报表分析：分析临时表、排序和完整扫描的SQL语句

指标优化

• 索引建议：基于查询模式的人工智能建议
• 未使用的索引查找器：识别从不读取的索引
• 重复检测：查找冗余和重叠的索引
• 索引统计：基数、选择性和使用指标

健康监测

• 健康检查：带评分的综合数据库健康评估
• 活动查询：实时查询监控
• 等待事件分析：识别I/O并锁定瓶颈
• 配置审查：设置分析和建议

存储引擎分析

• 发动机统计：分析存储引擎的使用和分布
• 碎片检测：使用OPTIMIZE建议查找碎片表
• 自动增量分析：检测接近溢出限制的列

InnoDB分析

• InnoDB状态：分析SHOW ENGINE INNODB状态
• 缓冲池分析：按模式和表详细说明缓冲池使用情况
• 交易分析：监视事务、锁等待和死锁

内存分析

• 内存计算：计算每个线程和全局缓冲区的使用情况
• 按主机/用户划分的内存：按连接源细分内存使用情况
• 表缓存分析：分析表打开缓存效率

复制监控

• 主/从状态：监视复制运行状况和延迟
• 加莱拉星团：MariaDB/Percona的完整Galera集群状态
• 组复制：MySQL组复制监控

证券分析

• 安全审计：检查匿名用户、弱密码、危险权限
• 用户权限：分析各级用户权限
• 审计日志：检查审核日志记录配置

资源和提示

• 内置最佳实践文档
• 常见调优任务的预配置提示
• 指数优化指南
• 配置优化指南

安装

来源

git clone https://github.com/yourusername/mysqltuner_mcp.git
cd mysqltuner_mcp
pip install -e .

使用pip（发布时）

pip install mysqltuner_mcp

配置

环境变量

连接URI格式

环境变量

export MYSQL_URI="mysql://user:password@host:3306/database"
export MYSQL_SSL=true
export MYSQL_SSL_CA="/path/to/ca.pem"  # Optional: CA certificate for verification

连接URI查询参数

export MYSQL_URI="mysql://user:password@host:3306/database?ssl=true&ssl_ca=/path/to/ca.pem"

用法

运行服务器

服务器支持三种传输模式： 标准 （默认）， 上海证券交易所，以及 可流式传输http.

# As a module
python -m mysqltuner_mcp

# Using the entry point
mysqltuner-mcp

# Explicitly specifying stdio mode
python -m mysqltuner_mcp --mode stdio

SSE模式（服务器发送事件）

使用服务器发送事件的HTTP传输，适用于基于web的MCP客户端：

# Start SSE server on default port 8080
python -m mysqltuner_mcp --mode sse

# Specify custom host and port
python -m mysqltuner_mcp --mode sse --host 127.0.0.1 --port 3000

# Enable debug mode
python -m mysqltuner_mcp --mode sse --debug

SSE端点：

• `http://:

/sse` -SSE连接端点

• `http://:

/messages/` -消息发布端点

流式HTTP模式

具有会话管理的现代HTTP传输：

# Start streamable HTTP server (stateful, with session tracking)
python -m mysqltuner_mcp --mode streamable-http

# Start in stateless mode (fresh transport per request)
python -m mysqltuner_mcp --mode streamable-http --stateless

# Specify custom host and port
python -m mysqltuner_mcp --mode streamable-http --host 127.0.0.1 --port 3000

可流式传输HTTP端点：

• `http://:

/mcp` -所有MCP通信的单一端点

命令行选项

MCP客户端配置

添加到您的MCP客户端配置中（例如，Claude Desktop）：

{
  "mcpServers": {
    "mysqltuner_mcp": {
      "command": "python",
      "args": ["-m", "mysqltuner_mcp"],
      "env": {
        "MYSQL_URI": "mysql://root:your_password@localhost:3306/your_database"
      }
    }
  }
}

启用SSL/TLS

{
  "mcpServers": {
    "mysqltuner_mcp": {
      "command": "python",
      "args": ["-m", "mysqltuner_mcp"],
      "env": {
        "MYSQL_URI": "mysql://root:your_password@localhost:3306/your_database",
        "MYSQL_SSL": "true",
        "MYSQL_SSL_CA": "/path/to/ca.pem"
      }
    }
  }
}

可用工具

性能工具

索引工具

健康工具

存储引擎工具

InnoDB工具

内存工具

复制工具

安全工具

报表分析工具

可用提示

需求

• Python 3.10+
• MySQL 5.7+或MySQL 8.0+
• performance_schema 已启用（用于完整功能）

MySQL权限

MySQL用户需要以下权限：

GRANT SELECT ON performance_schema.* TO 'your_user'@'%';
GRANT SELECT ON information_schema.* TO 'your_user'@'%';
GRANT PROCESS ON *.* TO 'your_user'@'%';
-- For EXPLAIN on user databases:
GRANT SELECT ON your_database.* TO 'your_user'@'%';

发展

设置开发环境

git clone https://github.com/yourusername/mysqltuner_mcp.git
cd mysqltuner_mcp
python -m venv .venv
source .venv/bin/activate  # or .venv\Scripts\activate on Windows
pip install -e .