FIWARE Orion模型上下文协议服务器

为FIWARE Orion Context Broker提供的模型上下文协议服务器,使LLMs如Claude能够管理NGSI-v2上下文实体——物联网设备、摄像头、传感器、车辆以及任何建模为数字孪生的现实世界对象。

  • by k2iser
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 k2iser/fiware-orion-mcp

使用说明

fiware orion mcp

MCP(模型上下文协议)服务器 FIWARE Orion上下文代理使像Claude这样的LLM能够管理NGSI-v2上下文实体——物联网设备、摄像头、传感器、车辆和任何被建模为数字孪生的现实世界对象。

目前还没有官方的FIWARE MCP。这是第一个。

什么是FIWARE Orion?

消防 是智能城市和物联网数据管理的开放标准(ETSI NGSI-LD)。这 Orion上下文代理 是它的核心组件——它存储所有实体的当前状态,并在情况发生变化时通知订阅者。

可用工具

工具 说明
orion_get_version 验证Orion连接和版本
orion_list_types 列出所有实体类型及其属性
orion_query_entities 按类型、模式、过滤器、地理位置查询实体
orion_get_entity 获取特定实体的完整详细信息
orion_create_entity 创建新的NGSI实体
orion_update_attributes 更新实体属性
orion_delete_entity 删除实体
orion_create_subscription 订阅属性更改通知
orion_list_subscriptions 列出活动订阅
quantumleap_get_history 获取实体的时间序列历史记录
quantumleap_get_type_history 获取跨实体类型的聚合历史记录

快速开始

1.启动固件栈(Docker)

cd docker
docker compose up -d
# Verify:
curl http://localhost:1026/version
curl http://localhost:8668/version

2.安装MCP服务器

pip install fiware-orion-mcp
# or from source:
pip install -e .

3.配置克劳德代码

添加到您的 ~/.claude/mcp.json 或项目MCP配置:

{
  "mcpServers": {
    "fiware-orion": {
      "command": "python",
      "args": ["-m", "fiware_mcp.server"],
      "env": {
        "ORION_URL": "http://your-orion-host:1026",
        "QUANTUMLEAP_URL": "http://your-ql-host:8668"
      }
    }
  }
}

4.环境变量

变量 默认值 描述
ORION_URL http://localhost:1026 Orion上下文代理URL
QUANTUMLEAP_URL http://localhost:8668 QuantumLeap URL
FIWARE_SERVICE (空) 多租户服务名称
FIWARE_SERVICE_PATH / 多租户服务路径

与Claude的示例会话

> List all entity types in the Context Broker
> Show me all Camera entities that are offline
> Get the full details of Camera:TIMONE-01
> Update Camera:TIMONE-01 status to "maintenance"
> Show me the uptime history of Camera:TIMONE-01 for the last 7 days

路线图

  • []NGSI-LD支持(猎户座LD)
  • []批量操作
  • []地理查询助手(查找点附近的实体)
  • []将实体导出为GeoJSON

许可证

麻省理工学院——欢迎投稿。