MCP Stdio 服务器 (MySQL/MariaDB)

本项目是与 Cursor IDE 联动的 Model Context Protocol (MCP) Stdio 服务器。 它返回 MySQL 或 MariaDB 数据库的表结构和关系。

✅ 功能

• 基于 MCP 官方 Python SDK
• stdio 模式与 Cursor IDE 联动
• 基于 .env 文件的数据库配置
• 返回表列表、列和外键关系
• 数据查询和分析功能
• 查询执行和优化功能
• 数据库监控功能
• 性能分析和优化建议

📦 安装

git clone <this-repo-url>
cd db-mcp-server
python -m venv venv
source venv/bin/activate  # 或者 venv\Scripts\activate (Windows)
pip install -r requirements.txt

⚙️ .env 配置

在根目录下创建 .env 文件，内容如下：

# Database connection settings for MCP Python server
DB_HOST=localhost
DB_USER=root
DB_PASSWORD=your_password
DB_NAME=your_db
DB_CHARSET=utf8mb4

🚀 运行

在 Cursor IDE 中添加 MCP Server > Transport: stdio > Command: python main.py

📡 支持方法

模式查询

• mysql.get_schema: 返回所有表结构 + 外键

数据查询和分析

• mysql.get_table_stats: 表格统计信息（行数、NULL 值比率、唯一值数）
• mysql.get_sample_data: 查询表格的示例数据
• mysql.get_column_stats: 特定列的详细统计信息

查询执行和优化

• mysql.execute_query: 执行安全的只读查询
• mysql.explain_query: 分析查询执行计划
• mysql.optimize_query: 查询优化建议

数据库监控

• mysql.get_db_status: 数据库状态信息（连接数、查询统计等）
• mysql.get_table_size: 表格大小信息
• mysql.get_index_usage: 索引使用统计

性能分析

• mysql.analyze_performance: 分析性能瓶颈
• mysql.suggest_indexes: 索引创建建议
• mysql.optimize_tables: 表格优化建议

📝 示例结果

模式查询

{
  "schema": {
    "users": {
      "columns": [...],
      "foreign_keys": [...]
    }
  }
}

表格统计

{
  "table_name": "users",
  "total_rows": 1000,
  "column_stats": {
    "id": {
      "total_rows": 1000,
      "null_count": 0,
      "null_ratio": 0.0,
      "unique_values": 1000
    }
  }
}

查询执行计划

{
  "explain_plan": [...],
  "handler_stats": {...},
  "suggestions": [
    {
      "type": "index",
      "message": "正在发生排序操作。请考虑为 ORDER BY 子句中使用的列添加索引。"
    }
  ]
}

性能分析

{
  "slow_queries": 5,
  "bottlenecks": [
    {
      "type": "large_table",
      "table": "orders",
      "rows": 1500000,
      "message": "表格 'orders' 包含 1,500,000 行。请考虑分区。"
    }
  ],
  "recommendations": [...]
}

✅ 要求

• Python 3.8+
• MySQL/MariaDB