# MCP

**Repository Path**: wx_e4de35b4a7/mcp

## Basic Information

- **Project Name**: MCP
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-17
- **Last Updated**: 2026-06-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# MySQL MCP Server - 数据中台分析服务

基于 MCP (Model Context Protocol) 的 MySQL 数据分析服务器，提供 19 个数据分析工具。

## ✨ 功能特性

### 核心工具 (14个)

| 工具 | 功能 |
|------|------|
| `list_tables` | 列出数据库所有表 |
| `describe_table` | 查看表结构定义 |
| `execute_query` | 执行只读 SQL 查询 |
| `get_database_status` | 数据库状态检查 |
| `profile_table` | 整表数据画像 |
| `profile_column` | 单字段深度画像 |
| `data_quality_score` | 数据质量评分 |
| `trend_analysis` | 时间序列趋势分析 |
| `anomaly_detect` | 异常值检测 |
| `correlation_matrix` | 字段相关性矩阵 |
| `group_stats` | 分组统计 |
| `top_n_analysis` | Top N 排行分析 |
| `export_query` | 导出查询结果 |
| `usage_stats` | 工具使用统计 |

### 高频场景工具 (5个新增)

| 工具 | 功能 | 解决场景 |
|------|------|---------|
| `get_dimension_values` | 获取维度唯一值 | 替代 SELECT DISTINCT |
| `regional_comparison_analysis` | 区域环比分析 | 自动生成对比报表 |
| `business_daily_report` | 业务日报生成 | 标准化日报输出 |
| `get_field_business_context` | 字段业务注释 | 理解字段含义 |
| `list_tables_by_category` | 表分类列表 | 快速定位业务表 |

## 🏗️ 架构

```
mysql-mcp-server/
├── startup.py           # 启动入口（MCP + Admin Panel）
├── server.py            # MCP 服务器核心（19个工具）
├── admin_panel.py       # 管理后台（Token + 审计）
├── requirements.txt     # Python 依赖
├── README.md            # 项目文档
├── LICENSE              # MIT 开源协议
├── .env.example         # 配置模板
├── systemd.example      # Systemd 服务示例
└── SERVER_DOCS.md       # 运维文档
```

## 🔧 安装部署

### 1. 环境要求

- Python 3.10+
- MySQL 数据库（远程或本地）
- Systemd（可选，用于服务管理）

### 2. 安装依赖

```bash
pip install -r requirements.txt
```

### 3. 配置环境变量

复制 `.env.example` 为 `.env`，填写实际配置：

```bash
cp .env.example .env
# 编辑 .env，填写 MySQL 连接信息和 Admin 密码
```

### 4. 运行服务

**直接运行：**
```bash
python startup.py
```

**Systemd 服务（推荐）：**
```bash
# 复制服务文件
sudo cp mysql-mcp.service.example /etc/systemd/system/mysql-mcp.service

# 编辑服务文件，填写环境变量
sudo vim /etc/systemd/system/mysql-mcp.service

# 启动服务
sudo systemctl daemon-reload
sudo systemctl enable mysql-mcp
sudo systemctl start mysql-mcp
```

## 🔐 鉴权系统

### MCP 接口鉴权

- **Bearer Token**: `Authorization: Bearer <token>`
- **客户端绑定**: `X-Machine-ID: <client-id>`
- **白名单路径**: `/admin`, `/docs`, `/openapi.json`

### 管理后台鉴权

- HTTP Basic Auth
- 用户名/密码在环境变量中配置

## 📊 API 端点

| 端点 | 协议 | 说明 |
|------|------|------|
| `/mcp` | MCP Streamable HTTP | MCP 协议端点 |
| `/admin` | HTTP | 管理后台页面 |
| `/admin/api/*` | REST API | 管理后台 API |
| `/docs` | HTTP | OpenAPI 文档 |

## 🛠️ 工具使用示例

### 获取维度值
```json
{
  "method": "get_dimension_values",
  "params": {
    "dimension": "区县名称",
    "table": "有效表"
  }
}
```

### 区域对比分析
```json
{
  "method": "regional_comparison_analysis",
  "params": {
    "region_field": "区县名称",
    "metric_field": "总订单",
    "date_current": "20260609",
    "date_previous": "20260608"
  }
}
```

### 业务日报生成
```json
{
  "method": "business_daily_report",
  "params": {
    "report_date": "20260609"
  }
}
```

## 📈 性能优化

- 表结构缓存，减少元数据查询
- SQL 安全限制，拒绝写操作
- 查询超时和行数限制
- 审计日志记录

## 🤝 兼容性

支持所有 MCP 客户端：
- myAI v4.5 超级智能体客户端
- Claude Desktop
- 其他 MCP 协议客户端

## 📝 开源协议

MIT License - 可自由使用、修改、分发

## 🙏 致谢

基于 MCP (Model Context Protocol) 协议开发