中国ETS MCP服务器
用于中国国家碳市场（CEA+CCER）交易数据的MCP服务器——具有交互式仪表板、数据查询和导出工具。
实时仪表板演示 --点击以互动方式浏览中国ETS数据。无需安装。
特性
- 市场数据查询 --按日期范围查询历史CEA和CCER交易数据
- 市场概况 --获取最新价格、价格范围和交易统计数据
- 数据导出 --下载CSV或XLSX格式的交易数据
- 交互式仪表板 --生成一个基于Plotly的HTML仪表板，其中包含烛台图、交易量分析和多语言支持（EN/CN/JA/KO）
数据源
| 市场 | 来源 | 覆盖范围 |
|---|---|---|
| 癌胚抗原 （碳排放配额） | 上海环境与能源交易所 | 2021-07至今 |
| 中国核证减排量 （中国认证减排） | CCER官方（CCER.com.cn） | 2024-01至今 |
快速开始
1.安装
推荐 （自动管理Python版本）：
git clone https://github.com/JIN-Z-pop/china-ets-mcp.git
cd china-ets-mcp
uv sync或者使用pip（需要Python 3.11+）：
pip install -e .2.下载数据
下载最新 data.db.zip 从 那么：
mkdir -p data
# Extract china_ets.db into data/ directory
unzip data.db.zip -d data/3.查看仪表板（无需MCP）
uv run china-ets-dashboard或者使用pip安装：
china-ets-dashboard这将生成一个交互式HTML仪表板，并在浏览器中打开它。
4.配置MCP（可选）
添加到您的 claude_desktop_config.json:
{
"mcpServers": {
"china-ets": {
"command": "python",
"args": ["-m", "china_ets_mcp.server_lite"],
"env": {
"DATA_DIR": "/path/to/china-ets-mcp/data"
}
}
}
}或者使用CLI入口点：
{
"mcpServers": {
"china-ets": {
"command": "china-ets-mcp-lite"
}
}
}5.与Claude一起使用
配置后，您可以询问Claude：
- *“向我展示最新的CEA市场摘要”*
- *“查询2025-01-01至2025-06-30的CEA交易数据”*
- *“将CCER数据下载为CSV格式”*
- *“为中国碳市场数据生成仪表板”*
MCP工具
| 工具 | 说明 |
|---|---|
query_trading_data | 按日期范围查询CEA或CCER历史数据 |
get_market_summary | 获取最新价格、统计数据和市场概述 |
download_data | 将数据导出为CSV或XLSX |
generate_dashboard | 使用Plotly图表创建交互式HTML仪表板 |
仪表盘
生成的仪表板包括：
- CEA价格趋势（折线图）
- CEA烛台+体积分析
- 年度价格分布（箱图）
- 月度交易量热图
- CCER平均价格趋势
- 多语言支持（英语、中文、日语、韩语）
项目结构
china-ets-mcp/
├── src/china_ets_mcp/
│ ├── server_lite.py # MCP server (4 tools)
│ ├── tools/
│ │ ├── query.py # Data query engine
│ │ ├── exporter.py # CSV/XLSX export
│ │ └── dashboard.py # Dashboard generator
│ └── db/
│ ├── models.py # SQLite schema
│ └── manager.py # Database operations
├── dashboard/
│ └── template.html # Plotly + i18n template
├── tests/ # Test suite
├── examples/ # Sample data
└── data/ # SQLite database (not in repo)发展
# Install dev dependencies
pip install -e ".[dev]"
# Run tests
pytest数据更新
交易数据通过GitHub Release定期更新。检查 发布页面 获取最新数据。
免责声明
此工具仅用于研究和教育目的。作者对准确性、完整性或适用于任何特定目的不作任何保证，也不对因使用而造成的任何损失或损害承担任何责任。使用此工具的风险完全由您自行承担。
本工具仅供研究与教育目的使用。作者不对其准确性、完整性或特定用途的适用性作任何保证，亦不对因使用本工具而产生的任何损失或损害承担责任。使用本工具的风险由用户自行承担。
许可证
麻省理工学院 -金和他快乐的AI兄弟