MCP服务器项目

什么是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时间戳）。