MCP mysql analyser

🚀 MCP MySQL分析器

](https://github.com/MrBozkay/mcp_mysql_analyser/releases/latest)   ](https://github.com/MrBozkay/mcp_mysql_analyser/releases)

使用 AI 与您的 MySQL 数据库进行自然语言交互！

MCP MySQL分析器它是一个强大的工具，允许您在所有支持MCP的AI平台上使用自然语言与MySQL数据库进行交互。它允许您在不编写单行SQL的情况下查看架构，运行查询和进行高级数据分析。

✨ 特色功能

• 🌐 通用 兼容 适用于所有支持MCP的平台
• 🗣️ 自然语言支持 - 使用土耳其语和英语与您的数据库交谈
• ⚡ 单命令设置 - 几分钟内准备好
• 🔍 智能方案分析 AI自动理解您的数据库
• 📊 高级 分析 - Churn，队列，异常值分析等
• 🛡️ 安全连接 - SSL支持和安全身份验证
• 🎯 自动批准 自动验证安全交易

🚀 快速入门

📦 安装

推荐方法 - 直接从GitHub：

# 1. Projeyi klonlayın
git clone https://github.com/MrBozkay/mcp_mysql_analyser.git
cd mcp_mysql_analyser

# 2. Otomatik kurulum
# Windows (PowerShell)
.\install-global.ps1

# Linux/Mac (Bash)
chmod +x install-global.sh && ./install-global.sh

替代 - Tarball 安装：

npm install -g https://github.com/MrBozkay/mcp_mysql_analyser/archive/v1.1.1.tar.gz

⚙️ 快速配置

# Otomatik kurulum (Kiro IDE için)
mcp-mysql-analyzer setup

# Konfigürasyonu doğrula
mcp-mysql-analyzer validate

# Çevre değişkenlerini kontrol et
mcp-mysql-analyzer env

🎯 支持的平台

💬 应用范例

土耳其语命令

"Veritabanımdaki tüm tabloları listele"
"Users tablosunun şemasını detaylı göster"
"Son 30 günde en çok satılan ürünleri analiz et"
"Müşteri churn oranını hesapla ve grafikle göster"
"Orders tablosunda yinelenen kayıtları bul"

英语命令

"Show me all tables in my database"
"Analyze the schema of the products table"
"Find outliers in the sales_amount column"
"Generate a cohort analysis for user retention"
"Create a churn analysis for the last quarter"

📋 内容

• 安装细节
• 平台配置
• 环境变量
• 现有车辆
• 高级使用
• 解决问题
• 找不到贡献

🔧 安装细节

系统要求

• Node.js 18.x 或更高
• MySQL 5.7+ 或 8.0+
• NPM 8.x 或更高
• 操作系统： Windows、macOS、Linux

安装选项

1️⃣ GitHub自动安装（推荐）

git clone https://github.com/MrBozkay/mcp_mysql_analyser.git
cd mcp_mysql_analyser

# Windows
.\install-global.ps1

# Linux/Mac
chmod +x install-global.sh && ./install-global.sh

此安装 ：

• ✅ 建立所有依赖
• ✅ 打字机
• ✅ 创建全局命令
• ✅ 适用于所有平台

二️⃣ NPM 直接安装

# Gelecekte mevcut olacak
npm install -g @mrbozkay/mcp_mysql_analyser

3️⃣ 手动安装

git clone https://github.com/MrBozkay/mcp_mysql_analyser.git
cd mcp_mysql_analyser
npm install
npm run build
npm pack
npm install -g ./mrbozkay-mcp_mysql_analyser-*.tgz

安装验证

# Komutun çalıştığını kontrol edin
mcp-mysql-analyzer --help

# Sürüm bilgisini görün
mcp-mysql-analyzer --version

# Çevre değişkenlerini kontrol edin
mcp-mysql-analyzer env

🔧 平台配置

🎯 Kiro IDE（推荐）

自动安装：

mcp-mysql-analyzer setup

手动配置： .kiro/settings/mcp.json 创建文件：

{
  "mcpServers": {
    "mysql-analyzer": {
      "command": "mcp-mysql-analyzer",
      "args": ["server"],
      "env": {
        "MYSQL_HOST": "localhost",
        "MYSQL_PORT": "3306",
        "MYSQL_USER": "your_username",
        "MYSQL_PASSWORD": "your_password",
        "MYSQL_DB": "your_database"
      },
      "autoApprove": [
        "connect", "list_databases", "list_tables", 
        "table_info", "get_table_ddl", "profile_table",
        "analyze_numeric_columns", "get_value_distribution"
      ]
    }
  }
}

🤖 克劳德桌面版

配置文件 ： claude_desktop_config.json

{
  "mcpServers": {
    "mysql-analyzer": {
      "command": "mcp-mysql-analyzer",
      "args": ["server"],
      "env": {
        "MYSQL_HOST": "localhost",
        "MYSQL_PORT": "3306",
        "MYSQL_USER": "your_username",
        "MYSQL_PASSWORD": "your_password",
        "MYSQL_DB": "your_database"
      }
    }
  }
}

文件位置 ：

• 窗户： %APPDATA%\Claude\claude_desktop_config.json
• macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
• Linux： ~/.config/Claude/claude_desktop_config.json

💻 VSCode

要求： 安装 MCP 扩展

配置 ： settings.json添加到：

{
  "mcp.servers": {
    "mysql-analyzer": {
      "command": "mcp-mysql-analyzer",
      "args": ["server"],
      "env": {
        "MYSQL_HOST": "localhost",
        "MYSQL_PORT": "3306",
        "MYSQL_USER": "your_username",
        "MYSQL_PASSWORD": "your_password",
        "MYSQL_DB": "your_database"
      }
    }
  }
}

✨ 光标IDE

配置文件 ： mcp.json

{
  "mcpServers": {
    "mysql-analyzer": {
      "command": "mcp-mysql-analyzer",
      "args": ["server"],
      "env": {
        "MYSQL_HOST": "localhost",
        "MYSQL_PORT": "3306",
        "MYSQL_USER": "your_username",
        "MYSQL_PASSWORD": "your_password",
        "MYSQL_DB": "your_database"
      }
    }
  }
}

🔍 谷歌双子座

配置 ：

{
  "servers": {
    "mysql-analyzer": {
      "command": "mcp-mysql-analyzer",
      "args": ["server"],
      "environment": {
        "MYSQL_HOST": "localhost",
        "MYSQL_PORT": "3306",
        "MYSQL_USER": "your_username",
        "MYSQL_PASSWORD": "your_password",
        "MYSQL_DB": "your_database"
      }
    }
  }
}

📱 其他 MCP 客户端

支持任何 MCP 协议的客户端的默认配置：

{
  "command": "mcp-mysql-analyzer",
  "args": ["server"],
  "env": {
    "MYSQL_HOST": "localhost",
    "MYSQL_PORT": "3306",
    "MYSQL_USER": "your_username",
    "MYSQL_PASSWORD": "your_password",
    "MYSQL_DB": "your_database"
  }
}

⚙️ 环境变量

基本配置

高级设置

设置环境变量

Windows（PowerShell）：

$env:MYSQL_HOST="localhost"
$env:MYSQL_PORT="3306"
$env:MYSQL_USER="your_username"
$env:MYSQL_PASSWORD="your_password"
$env:MYSQL_DB="your_database"
$env:MYSQL_SSL="false"

Linux/Mac（Bash）：

export MYSQL_HOST=localhost
export MYSQL_PORT=3306
export MYSQL_USER=your_username
export MYSQL_PASSWORD=your_password
export MYSQL_DB=your_database
export MYSQL_SSL=false

永久设置（.env 文件）：

MYSQL_HOST=localhost
MYSQL_PORT=3306
MYSQL_USER=your_username
MYSQL_PASSWORD=your_password
MYSQL_DB=your_database
MYSQL_SSL=false

🛠️ 现有车辆

🔍 方案和结构分析

📊 数据 分析

📈 Churn和队列分析

🚀 高级使用

全球指令

# MCP server başlat (varsayılan)
mcp-mysql-analyzer

# Kiro IDE için otomatik kurulum
mcp-mysql-analyzer setup

# Konfigürasyonu doğrula
mcp-mysql-analyzer validate

# Çevre değişkenlerini göster
mcp-mysql-analyzer env

# Yardım göster
mcp-mysql-analyzer --help

平台特定用例

Kiro 在 IDE 中

"MySQL veritabanımdaki tabloları göster"
"Users tablosunun şemasını analiz et"
"Son 30 günde kayıt olan kullanıcıları listele"
"Orders tablosunda outlier'ları bul"

克劳德桌面

"Can you show me the schema of my products table?"
"Analyze the sales data for trends"
"Find duplicate entries in the customers table"
"Generate a churn analysis for the last quarter"

VSCode 的

"List all tables in the inventory database"
"Show me the top 10 customers by purchase amount"
"Create a cohort analysis for user retention"
"Detect anomalies in the transaction amounts"

安全和自动批准

自动批准安全交易列表：

"autoApprove": [
  "connect",
  "list_databases", 
  "list_tables",
  "table_info",
  "get_table_ddl",
  "profile_table",
  "analyze_numeric_columns",
  "get_value_distribution",
  "get_null_report"
]

🔧 解决问题

常见问题

连接问题

# Bağlantıyı test edin
mcp-mysql-analyzer env

# MySQL servisinin çalıştığını kontrol edin
mysql -h localhost -u your_username -p

命令未找到

# Global kurulumu kontrol edin
npm list -g @mrbozkay/mcp_mysql_analyser

# PATH'i kontrol edin
echo $PATH  # Linux/Mac
echo $env:PATH  # Windows

配置问题

# Konfigürasyonu doğrulayın
mcp-mysql-analyzer validate

# Kiro IDE için yeniden kurulum
mcp-mysql-analyzer setup --force

调试模块

# Detaylı log ile çalıştırın
DEBUG=* mcp-mysql-analyzer

# Sadece MCP logları
DEBUG=mcp:* mcp-mysql-analyzer

性能优化

# Bağlantı limitini artırın
export MYSQL_CONNECTION_LIMIT=10

# Timeout süresini ayarlayın
export DEFAULT_QUERY_TIMEOUT=30000

# Örnek limitini azaltın
export DEFAULT_SAMPLE_LIMIT=1000

🤝 找不到贡献

欢迎您的贡献！以下是您如何贡献：

🐛 错误报告

1. 访问页面
2. 检查当前问题
3. 创建一个新问题并添加以下内容：

- 错误的详细说明 - 重新生产步骤 - 系统信息（操作系统，Node.js版本） - 错误日志

💡 功能建议

1. 讨论 分享您的建议
2. 解释功能的好处
3. 如果可能，添加使用场景

🔧 代码贡献

1. "yi fork edin
2. 创建 Feature Branch： git checkout -b feature/amazing-feature
3. 提交您的更改： git commit -m 'Add amazing feature'
4. Branch'inizi推了进去： git push origin feature/amazing-feature
5. 创建 Pull Request

📝 文档

• README改进
• 代码评论
• 应用范例
• 翻译贡献

🧪 测试贡献

• 新的测试场景
• 基于属性的测试改进
• 平台兼容性测试

📄 许可证

这个项目 MIT 学士 在下面授权。了解详情 许可证 看看档案。

🙏 谢谢

• 模型上下文协议 对于团队协议
• MySQL 为团队提供强大的数据库
• TypeScript 为了团队的类型安全
• 所有贡献者和用户

📞 联系方式

• github： 博兹凯先生
• 问题：
• 讨论：

______________________________________________________________________

⭐ 如果你喜欢这个项目，别忘了给它一颗星。

](https://github.com/MrBozkay/mcp_mysql_analyser/stargazers) ](https://github.com/MrBozkay/mcp_mysql_analyser/network/members)