FIWARE MCP 服务器

这是 FIWARE 模型上下文协议 (MCP) 服务器的首次实现，该服务器在上下文代理和其他服务之间架起了桥梁。该服务器实现了与 FIWARE 上下文代理交互的基本操作。

目标

为 FIWARE 创建基本的 MCP 服务器实现
提供用于 Context Broker 交互的简单工具
使用 Context Broker 演示基本意图 CRUD 操作
为更复杂的 MCP 实现奠定基础

特征

Context Broker 版本检查
Context Broker 的查询功能
实体发布和更新

先决条件

Python 3.7 或更高版本
pip（Python 包安装程序）
访问 FIWARE Context Broker 实例

安装

克隆此存储库：

git clone <repository-url>
cd FIWARE_MCP_01

安装所需的依赖项：

pip install -r requirements.txt

Claude 桌面集成

mcp install server.py

# Custom name
mcp install server.py --name "FIWARE MCP Server"

# Environment variables, if any
mcp install server.py -v API_KEY=abc123 -v DB_URL=postgres://...
mcp install server.py -f .env

用法

启动 MCP 服务器：

python server.py
# or
mcp run server.py

服务器默认从127.0.0.1:5001启动。

可用工具

CB_版本
- 检查 Context Broker 的版本
- 默认参数：address="localhost",port=1026
- 返回：包含版本信息的 JSON 字符串
查询_CB
- 查询上下文代理
- 参数：
  - 地址（默认值：“localhost”）
  - 端口（默认值：1026）
  - 查询（默认值：“”）
- 返回：包含查询结果的 JSON 字符串
发布到 CB
- 在 Context Broker 中发布或更新实体
- 参数：
  - 地址（默认值：“localhost”）
  - 端口（默认值：1026）
  - entity_data（必需：包含实体信息的字典）
- 返回：带有操作状态的 JSON 字符串

示例用法

# Example entity data
entity_data = {
    "id": "urn:ngsi-ld:TemperatureSensor:001",
    "type": "TemperatureSensor",
    "temperature": {
        "type": "Property",
        "value": 25.5
    },
    "@context": "https://uri.etsi.org/ngsi-ld/v1/ngsi-ld-core-context.jsonld"
}

# Publish to Context Broker
result = publish_to_CB(entity_data=entity_data)

配置

可以通过修改server.py中的以下参数来配置服务器：

主机地址
端口号
超时设置

错误处理

该服务器包括针对以下方面的全面错误处理：

网络连接问题
来自上下文代理的无效响应
格式错误的实体数据
服务器关闭

贡献

请随时提交问题和增强请求！

执照

该项目采用 Apache License 2.0 许可。

Integrations