Overview
什么是MCP服务器项目？
MCP服务器项目是一个基于MCP（Model Control Protocol）的服务器，用于与大数据平台交互。主要提供天气数据查询服务（获取美国各州的天气预报和警报）和大数据指标上传服务（向大数据平台添加测点数据）。适用于需要集成大数据平台并获取天气数据的开发者和运维人员。
如何用MCP服务器项目？
使用Python 3.9+，安装依赖后运行python mcp_server.py。也可通过uv run .\mcp_server.py启动。主要调用add_index_data函数上传测点数据，参数包括系统编码、设备编码、测点编码、时间类型和时间周期等。
主要功能
- 获取美国各州天气警报（
get_alerts） - 获取指定坐标位置的天气预报（
get_forecast） - 上传各类指标数据至大数据平台
- 按不同时间周期（实时、分钟、小时、日、月、年）添加测点数据
- 自动根据参数生成对应格式的时间戳数据
使用场景
- 将生产设备的实时或周期性能指标上传至企业大数据平台
- 在运维系统中集成天气预警信息，辅助决策
- 批量补录历史测点数据（支持单个日期、多个日期、日期范围）
- 能源管理系统中的小时级或日级能耗数据上报
常见问题
如何运行MCP服务器项目？
可以通过uv run .\mcp_server.py或直接运行mcp_server.py文件。若遇Python启动报错，删除.venv目录后执行uv sync即可。
环境要求是什么？
需要Python 3.9+，依赖包包括httpx和mcp。安装依赖使用pip install -r requirements.txt。
支持哪些数据上传类型？
支持add_index_data函数，可上传实时（REAL_TIME）、分钟、小时、日、月、年等时间周期的测点数据。时间周期参数支持单个日期、逗号分隔的多日期以及波浪线连接的日期范围。
时间类型的格式是怎样的？
实时数据格式为年-月-日 时:分:秒，分钟为年-月-日 时:分，小时为年-月-日 时，日为年-月-日，月为年-月，年为年。例如小时范围可写为2023-01-01 00~2023-01-01 23。
调用结果如何表示？
成功添加数据后返回类似“数据添加成功!”的消息，并显示系统编码、设备编码、测点编码、时间类型、数据值、添加的时间点数量及时间点样例（Unix时间戳）。
