Dncampo FIWARE MCP Server

🚀 FIWARE MCP 服務器

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

🚀 快速開始

FIWARE MCP 服務器為上下文代理和其他服務提供交互支持。以下是使用前的準備和啟動步驟：

先決條件

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

安裝步驟

1. 克隆此倉庫：

git clone <repository-url>
cd FIWARE_MCP_01

2. 安裝所需的依賴項：

pip install -r requirements.txt

啟動服務器

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

服務器將在 127.0.0.1:5001 默認啟動。

✨ 主要特性

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

📦 安裝指南

克隆倉庫

git clone <repository-url>
cd FIWARE_MCP_01

安裝依賴

pip install -r requirements.txt

Claude Desktop 集成

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

💻 使用示例

基礎用法

# 實體數據示例
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)

可用工具

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 字符串

📚 詳細文檔

配置

通過修改 server.py 中的以下參數可以配置服務器：

• 主機地址
• 端口號
• 超時設置

錯誤處理

該服務器包含全面的錯誤處理，包括：

• 網絡連接問題
• 上下文代理返回的有效響應
• 格式錯誤的實體數據
• 服務器關閉

📄 許可證

此項目根據 Apache 許可證 2.0 進行許可。

🤝 貢獻

隨時提交問題和改進請求！