Metadata-Version: 2.4
Name: data-export-mcp-server
Version: 0.1.0
Summary: MCP server: JSON/MaxCompute export to Excel and OSS
Author: wengshimeng
License-Expression: Apache-2.0
License-File: LICENSE
Keywords: alibaba-cloud,cursor,excel,maxcompute,mcp,oss
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
Requires-Dist: mcp
Requires-Dist: openpyxl
Requires-Dist: oss2
Requires-Dist: pandas
Requires-Dist: pyodps
Requires-Dist: python-dotenv
Description-Content-Type: text/markdown

# Data Export MCP Server

通过 **stdio** 提供 MCP 工具：JSON / MaxCompute 查询导出 Excel 并上传 OSS。

## 依赖

- Python ≥ 3.10

## 本地开发

在**仓库根目录** `develop_mcp`：

```bash
pip install -e .
data-export-mcp-server
```

或在 `data-export-mcp-server` 下（需已安装依赖）：

```bash
cd data-export-mcp-server
pip install -r requirements.txt
python data_export_server.py
```

兼容旧命令：

```bash
data-export-server
```

## 发布到 PyPI

在仓库根目录执行：

```bash
python -m pip install --upgrade build twine
python -m build
python -m twine check dist/*
python -m twine upload dist/*
```

发布成功后，可直接通过 `uvx` 拉起：

```bash
uvx data-export-mcp-server
```

如果你想先验证 TestPyPI，可先上传测试仓库：

```bash
python -m twine upload --repository testpypi dist/*
uvx --index-url https://test.pypi.org/simple/ data-export-mcp-server
```

## 环境变量

将 `.env` 放在仓库根、`data-export-mcp-server` 下（见 `server.py` 加载顺序）。

- **OSS**：`OSS_ACCESS_KEY_ID`、`OSS_ACCESS_KEY_SECRET`、`OSS_ENDPOINT`、`OSS_BUCKET_NAME`
- **MaxCompute（可选）**：`ODPS_ACCESS_ID`、`ODPS_ACCESS_KEY`、`ODPS_PROJECT`、`ODPS_ENDPOINT`
- **可选**：`MCP_LOG_LEVEL`（默认 `ERROR`）

## 接入 Cursor / MCP 客户端

在客户端配置中使用 **stdio**，启动命令示例：

```json
{
  "mcpServers": {
    "data-export": {
      "command": "uvx",
      "args": ["data-export-mcp-server"],
      "env": {}
    }
  }
}
```

若不通过 `uvx`，也可将 `command` 改为本机 `python` 路径，`args` 为 `["-m", "mcp_servers.data_export.server"]`，并设置 `cwd` 为 `data-export-mcp-server` 或在 `PYTHONPATH` 中包含该目录。
