FIWARE MCP Server

FIWARE MCP服务器

 

这是FIWARE模型上下文协议（MCP）服务器的第一个实现，它在上下文代理和其他服务之间提供了一个桥梁。服务器实现了与FIWARE Context Broker交互的基本操作。

目标

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

特性

• 上下文代理版本检查
• Context Broker的查询功能
• 实体发布和更新

先决条件

• Python 3.7或更高版本
• pip（Python包安装程序）
• 访问FIWARE上下文代理实例

安装

1. 克隆此存储库：

git clone 
cd FIWARE_MCP_01

1. 安装所需的依赖项：

pip install -r requirements.txt

Claude桌面集成

Claude Desktop应通过STDIO启动服务器。请勿在此服务器上使用“mcp install”或“mcp run”。

示例配置（根据您的环境调整路径）：

{
  "mcpServers": {
    "CB-assistant": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "requests>=2.31.0",
        "--with",
        "fastmcp>=0.3.0",
        "python",
        "PATH\\TO\\FIWARE-MCP-Server\\server.py"
      ]
    }
  }
}

如果依赖项是用pip安装的，则可以选择：

{
  "mcpServers": {
    "CB-assistant": {
      "command": "python",
      "args": [
        "PATH\\TO\\FIWARE-MCP-Server\\server.py"
      ]
    }
  }
}

用法

默认情况下，运行脚本会以STDIO模式启动服务器。使用 --http 启动HTTP服务器。

• STDIO（默认）：

python server.py

• HTTP模式：

python server.py --http

• HTTP主机/端口（可选）：

python server.py --http --host 127.0.0.1 --port 5001

跑步时 --http，服务器绑定到提供的主机/端口，并使用无状态HTTP会话与可流式传输的HTTP客户端兼容。

使用ngrok重定向（HTTP模式）

要通过外部API（例如OpenAI Responses API）使用LLM，您可能需要将本地MCP服务器暴露在互联网上。在HTTP模式下运行时，使用ngrok创建到服务器的公共HTTPS隧道。

1. 注册地址：https://ngrok.com并为您的操作系统安装ngrok客户端。
2. 将您的ngrok身份验证令牌添加到客户端（遵循ngrok的操作系统特定设置）。例如：

- ngrok（v3）配置命令：ngrok配置添加authtoken\

1. 以HTTP模式启动MCP服务器（如果尚未运行）。例子：

- python服务器.py--http--主机127.0.0.1--端口5001

1. 启动一个ngrok隧道，将其转发到您的HTTP服务器：

- ngrok httphttp://127.0.0.1:5001 （如果配置不同，请更换主机/端口）

1. 一旦ngrok运行，它将显示一个或多个公共转发URL。MCP端点将在以下位置可访问：

- ｛PUBLIC_URL｝/mcp

注意：确保您的身份验证令牌安全。当ngrok运行时，公共URL保持活动状态，当您停止隧道时，将无法访问。

可用工具

1. CB_版本

- 检查上下文代理的版本 - 默认参数：地址=“localhost”，端口=1026 - 返回：包含版本信息的JSON字符串

1. query_CB

- 查询上下文代理 - 参数： - 地址（默认值：“localhost”） - 端口（默认值：1026） - 查询（默认值：“”） - 返回：包含查询结果的JSON字符串

1. publish_to_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:

• 主机地址（仅HTTP模式）
• 端口号（仅限HTTP模式）
• 超时设置

错误处理

该服务器包括全面的错误处理功能，用于：

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

贡献

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

许可证

此项目根据Apache许可证2.0获得许可。