ODS MCP Server

ODS MCP Server 是一个基于 Model Context Protocol (MCP) 的服务器，用于从 ODS (Operational Data Service) 系统获取 IoT 传感器数据。

功能特性

工具 (Tools)

• get_latest_data: 获取指定标签的最新传感器数据。支持批量查询。
• get_historical_data: 获取指定时间范围内的历史传感器数据。支持数据分组、排序及缺失数据检测。
• get_data_at_point: 获取指定时间点前最近的一个数据点。

提示词 (Prompts)

• analyze_sensor_status: 生成用于分析指定传感器状态的提示词模板。

资源 (Resources)

• ods://tags/readme: 查看标签访问的说明文档。
• ods://tags/{tagName}: 通过 URI 直接访问特定传感器标签的数据。

配置

本服务通过环境变量进行配置。请将项目根目录下的 .env.example 复制为 .env 并填入您的配置信息：

• ODS_API_BASE_URL: ODS API 基础地址
• ODS_API_TOKEN: 访问令牌
• TAG_PREFIX: 标签前缀 (默认: 空字符串，如果不设置则不会自动添加前缀)

开发

1. 安装依赖

npm install

2. 构建

npm run build

3. 本地调试

本项目包含 VS Code 调试配置。

1. 确保已创建并配置 .env 文件。
2. 在 VS Code 中按 F5 启动调试 ("Debug MCP Server")。

4. 运行

npm start