金大哥 - FIWARE-MCP-Server MCP 详情

article

README

🚀 FIWARE MCP 服务器

这是一个 FIWARE 模型上下文协议 (MCP) 服务器的初始实现，它在上下文代理和其他服务之间搭建了一座桥梁，实现了与 FIWARE 上下文代理交互的基本操作。

🚀 快速开始

本项目为 FIWARE 模型上下文协议 (MCP) 服务器的初始实现，为上下文代理和其他服务提供交互桥梁。按照以下步骤，你可以快速开启使用之旅。

✨ 主要特性

上下文代理版本检查：可检查上下文代理的版本。
查询上下文代理的功能：能对上下文代理进行查询操作。
实体发布和更新：支持在上下文代理中发布和更新实体。

📦 安装指南

先决条件

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

安装步骤

克隆此仓库：

git clone <repository-url>
cd FIWARE_MCP_01

安装所需的依赖项：

pip install -r requirements.txt

Claude 桌面集成

mcp install server.py

# 自定义名称
mcp install server.py --name "FIWARE MCP 服务器"

# 环境变量，如果有需要
mcp install server.py -v API_KEY=abc123 -v DB_URL=postgres://...
mcp install server.py -f .env

💻 使用示例

基础用法

启动 MCP 服务器：

python server.py
# 或者
mcp run server.py

服务器将默认在 127.0.0.1:5001 上运行。

可用工具

CB_version
- 检查上下文代理的版本
- 默认参数：address="localhost"，port=1026
- 返回：包含版本信息的 JSON 字符串
query_CB
- 查询上下文代理
- 参数：
  - address（默认："localhost"）
  - port（默认: 1026）
  - query（默认: ""）
- 返回：查询结果的 JSON 字符串
publish_to_CB
- 发布或更新上下文代理中的实体
- 参数：
  - address（默认: "localhost"）
  - port（默认: 1026）
  - entity_data（必需: 包含实体信息的字典）
- 返回：操作状态的 JSON 字符串

高级用法

# 实体数据示例
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"
}

# 发布到上下文代理
result = publish_to_CB(entity_data=entity_data)

📚 详细文档

配置

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

主机地址
端口号
超时设置

错误处理

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

网络连接问题
上下文代理返回的有效响应
实体数据格式不正确
服务器关闭

📄 许可证

此项目根据 Apache License 2.0 许可。

🌟 贡献

欢迎提交问题和增强请求！

FIWARE-MCP-Server