使用说明

🚀 MCP MySQL分析器

使用 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

🎯 支持的平台

平台	硬质合金	Kurulum
🎯 开发 IDE	✅ 那里支持。 `mcp-mysql-analyzer setup`
🤖 克劳德桌面版	✅ 全面支持	手动配置
💻 VSCode	✅ MCP 扩展	settings.json
✨ 光标IDE	✅ 谭德斯泰克	mcp.json
🔍 谷歌双子座	✅ MCP 支持	船舶配置
📱 其他 MCP 客户端	✅ 通用	标准 MCP 协议

💬 应用范例

土耳其语命令

"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"
  }
}

⚙️ 环境变量

基本配置

变量	描述	默认	强制
`MYSQL_HOST` MySQL服务器地址 `localhost`	✅
`MYSQL_PORT` MySQL端口号 `3306`	❌
`MYSQL_USER` MySQL用户名 `root`	✅
`MYSQL_PASSWORD` MySQL密码 `''`	❌
`MYSQL_DB` 默认数据库。 `null`	❌
`MYSQL_SSL` SSL连接。 `false`	❌

高级设置

变量	描述	默认
`MYSQL_CONNECTION_LIMIT` 连接的最大数量。 `5`
`DEFAULT_SAMPLE_LIMIT`	默认样本限制	`10000`
`DEFAULT_QUERY_TIMEOUT`	Sorgu超时（毫秒）	`15000`

设置环境变量

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

🛠️ 现有车辆

🔍 方案和结构分析

车辆	说明	使用
`connect` 连接到 MySQL 数据库连接测试
`list_databases`	列出所有数据库	“列出数据库”
`list_tables`	列出表格	“显示表格”
`table_info`	显示表详细信息	“显示 Users 表的架构”
`get_table_ddl`	CREATE TABLE	“显示表结构”

📊 数据分析

车辆	说明	使用
`profile_table`	“分析表格”
`analyze_numeric_columns`	分析数字列	“分析数字数据”
`get_value_distribution`	显示值分布	“显示类别分布”
`detect_outliers`	查找异常值	“检测异常值”
`find_duplicates` 查找重复的记录查找重复的记录
`get_null_report`	创建 NULL 值报告	“分析缺少的数据”

📈 Churn和队列分析

车辆	说明	使用
`generate_churn_sql_basic`	基本churn分析	分析客户损失
`generate_cohort_sql` 队列分析	“计算用户保留率”
`generate_survival_sql` 生存分析（Survival Analysis）
`generate_mrr_churn_sql` MRR churn分析	“分析收入损失”
`suggest_churn_mapping`	Churn的列建议	“建议适合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

🤝 找不到贡献

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

🐛 错误报告

GitHub 问题访问页面
检查当前问题
创建一个新问题并添加以下内容：
- 错误的详细说明
- 重新生产步骤
- 系统信息（操作系统，Node.js版本）
- 错误日志

💡 功能建议

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

🔧 代码贡献

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

📝 文档

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

🧪 测试贡献

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

📄 许可证

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

🙏 谢谢

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

📞 联系方式

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

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