Metadata-Version: 2.3
Name: finedo-lzy-qccd-demo3-mcp-server
Version: 0.2.4
Summary: 新能源汽车充电数据分析 MCP 服务（自然语言查询充电站运营/收入/订单/目标数据）
Author: yangzhongsir
Author-email: yangzhongsir <2169951186@qq.com>
Requires-Dist: mcp[cli]>=1.28.1
Requires-Dist: pymysql>=1.1.0
Requires-Dist: python-dotenv>=1.0.0
Requires-Python: >=3.13
Description-Content-Type: text/markdown

# finedo-lzy-qccd-demo3-mcp-server

新能源汽车充电数据分析 MCP 服务。用自然语言查询充电站运营、收入、订单、目标达成等数据。

> 数据源为内网 MySQL（仅内网环境可用）。非内网环境服务可正常启动，但查询会返回连接错误。

## 环境变量配置

支持两种方式配置数据库连接：

### 方式 1：.env 文件（推荐）

在项目根目录创建 `.env` 文件：

```bash
DB_HOST=your-mysql-host
DB_PORT=3306
DB_DATABASE=your-database
DB_USER=your-username
DB_PASSWORD=your-password
```

### 方式 2：系统环境变量

```bash
export DB_HOST="your-mysql-host"
export DB_DATABASE="your-database"
export DB_USER="your-username"
export DB_PASSWORD="your-password"
export DB_PORT="3306"  # 可选
```

## 使用（uvx）

在 MCP 客户端（Cline / Claude Desktop / Cursor 等）配置：

```json
{
  "mcpServers": {
    "ev-charging-analyst": {
      "command": "uvx",
      "args": ["finedo-lzy-qccd-demo3-mcp-server"]
    }
  }
}
```

> 注意：
> - 使用 uvx 运行时，需要在 **项目根目录**（或 MCP 客户端的工作目录）放置 `.env` 文件
> - 或者设置系统环境变量

## 工具

- `analyze(question, context?)` — 自然语言分析入口，如"贵阳市和遵义市收入对比"、"充电站使用率多少"、"年度目标完成情况"
- `analyze_status()` — 服务状态与支持场景

## 本地开发

```bash
cp .env.example .env
# 编辑 .env 填入实际的数据库配置
uv sync
uv run finedo-lzy-qccd-demo3-mcp-server   # stdio 模式启动
```

## 构建与发布

```bash
uv build
uv publish   # 需要 PyPI token（UV_PUBLISH_TOKEN 环境变量或 --token）
```
