FIWARE MCP-сервер
Это первая реализация сервера FIWARE Model Context Protocol (MCP), который обеспечивает мост между Context Broker и другими службами. Сервер реализует базовые операции для взаимодействия с FIWARE Context Broker.
Цели
- Создать базовую реализацию сервера MCP для FIWARE
- Предоставьте простые инструменты для взаимодействия с Context Broker
- Демонстрация базовых операций CRUD с использованием Context Broker
- Служить основой для более сложных реализаций MCP
Функции
- Проверка версии Context Broker
- Возможности запроса для Context Broker
- Публикация и обновление сущностей
Предпосылки
- Python 3.7 или выше
- pip (установщик пакетов Python)
- Доступ к экземпляру FIWARE Context Broker
Установка
- Клонируйте этот репозиторий:
git clone <repository-url>
cd FIWARE_MCP_01
- Установите необходимые зависимости:
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 .
Доступные инструменты
- CB_версия
- Проверяет версию Context Broker
- Параметры по умолчанию: адрес="localhost", порт=1026
- Возвращает: строку JSON с информацией о версии.
- запрос_CB
- Запрашивает контекстный брокер
- Параметры:
- адрес (по умолчанию: "localhost")
- порт (по умолчанию: 1026)
- запрос (по умолчанию: "")
- Возвращает: строку JSON с результатами запроса.
- опубликовать_в_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.