FIWARE Context Broker

🚀 FIWARE MCP 服務器

FIWARE MCP 服務器是 FIWARE 模型上下文協議（MCP）的首個實現，它搭建了上下文代理與其他服務間的橋樑，實現了與上下文代理交互的基本操作。

🚀 快速開始

FIWARE MCP 服務器為上下文代理和其他服務提供了交互的橋樑。以下是快速啟動該服務器的步驟：

# 克隆倉庫
git clone <repository-url>
cd FIWARE_MCP_01

# 安裝依賴
pip install -r requirements.txt

# 啟動服務器
python server.py
# 或者
mcp run server.py

服務器將默認在 127.0.0.1:5001 上運行。

✨ 主要特性

• 上下文代理版本檢查：可檢查上下文代理的版本。
• 上下文代理查詢能力：支持對上下文代理進行查詢操作。
• 實體發佈和更新：能夠在上下文代理中發佈或更新實體。

📦 安裝指南

先決條件

• Python 3.7 或更高版本
• pip（Python 包安裝程序）
• 對 FIWARE 上下文代理實例的訪問權限

安裝步驟

1. 克隆此倉庫：

git clone <repository-url>
cd FIWARE_MCP_01

2. 安裝所需的依賴項：

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

高級用法

可用工具

1. CB_version
   • 功能：檢查上下文代理的版本
   • 默認參數：address="localhost"，port=1026
   • 返回：包含版本信息的 JSON 字符串
2. query_CB
   • 功能：查詢上下文代理
   • 參數：
     • address（默認："localhost"）
     • port（默認: 1026）
     • query（默認: ""）
   • 返回：查詢結果的 JSON 字符串
3. 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 許可。

貢獻

歡迎提交問題和增強請求！