FIWARE MCP-сервер

Это первая реализация сервера FIWARE Model Context Protocol (MCP), который обеспечивает мост между Context Broker и другими службами. Сервер реализует базовые операции для взаимодействия с FIWARE Context Broker.

Цели

• Создать базовую реализацию сервера MCP для FIWARE

• Предоставьте простые инструменты для взаимодействия с Context Broker

• Демонстрация базовых операций CRUD с использованием Context Broker

• Служить основой для более сложных реализаций MCP

Related MCP server: Synapse MCP Server

Функции

• Проверка версии Context Broker

• Возможности запроса для Context Broker

• Публикация и обновление сущностей

Предпосылки

• Python 3.7 или выше

• pip (установщик пакетов Python)

• Доступ к экземпляру FIWARE Context Broker

Установка

1. Клонируйте этот репозиторий:

git clone <repository-url>
cd FIWARE_MCP_01

2. Установите необходимые зависимости:

pip install -r requirements.txt

Интеграция Claude Desktop

mcp install server.py

# Custom name
mcp install server.py --name "FIWARE MCP Server"

# Environment variables, if any
mcp install server.py -v API_KEY=abc123 -v DB_URL=postgres://...
mcp install server.py -f .env

Использование

Запустите MCP-сервер:

python server.py
# or
mcp run server.py

По умолчанию сервер запустится по адресу 127.0.0.1:5001 .

Доступные инструменты

1. CB_версия

   • Проверяет версию Context Broker

   • Параметры по умолчанию: адрес="localhost", порт=1026

   • Возвращает: строку JSON с информацией о версии.

2. запрос_CB

   • Запрашивает контекстный брокер

   • Параметры:

     • адрес (по умолчанию: "localhost")

     • порт (по умолчанию: 1026)

     • запрос (по умолчанию: "")

   • Возвращает: строку JSON с результатами запроса.

3. опубликовать_в_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 :

• Адрес хоста

• Номер порта

• Настройки тайм-аута

Обработка ошибок

Сервер включает в себя комплексную обработку ошибок для:

• Проблемы с сетевым подключением

• Недействительные ответы от Context Broker

• Неправильно сформированные данные сущности

• Выключение сервера

Внося вклад

Не стесняйтесь отправлять сообщения о проблемах и запросы на улучшения!

Лицензия

Данный проект лицензирован по лицензии Apache License 2.0.