FIWARE MCP Server

🚀 FIWARE MCP 服務器

這是一個 FIWARE 模型上下文協議 (MCP) 服務器的初始實現，它在上下文代理和其他服務之間搭建了一座橋樑，實現了與 FIWARE 上下文代理交互的基本操作。

🚀 快速開始

本項目是 FIWARE MCP 服務器的初始實現，為上下文代理和其他服務提供交互橋樑。以下是快速搭建並使用該服務器的步驟：

1. 克隆倉庫並安裝依賴。
2. 啟動服務器。
3. 利用提供的工具與上下文代理進行交互。

✨ 主要特性

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

📦 安裝指南

先決條件

• 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

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

可用工具

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 許可。

👋 貢獻

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