Servidor FIWARE MCP

Esta es la primera implementación de un servidor de Protocolo de Contexto de Modelo (MCP) FIWARE que proporciona un puente entre el Agente de Contexto y otros servicios. El servidor implementa las operaciones básicas para interactuar con un Agente de Contexto FIWARE.

Objetivos

Cree una implementación básica de servidor MCP para FIWARE
Proporcionar herramientas sencillas para la interacción con Context Broker
Demuestre operaciones CRUD de intención básica con Context Broker
Servir como base para implementaciones de MCP más complejas

Características

Comprobación de la versión de Context Broker
Capacidades de consulta para Context Broker
Publicación y actualización de entidades

Prerrequisitos

Python 3.7 o superior
pip (instalador de paquetes de Python)
Acceso a una instancia de FIWARE Context Broker

Instalación

Clonar este repositorio:

git clone <repository-url>
cd FIWARE_MCP_01

Instale las dependencias necesarias:

pip install -r requirements.txt

Integración de 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

Uso

Inicie el servidor MCP:

python server.py
# or
mcp run server.py

El servidor se iniciará en 127.0.0.1:5001 de forma predeterminada.

Herramientas disponibles

Versión CB
- Comprueba la versión del Context Broker
- Parámetros predeterminados: dirección="localhost", puerto=1026
- Devuelve: cadena JSON con información de la versión
consulta_CB
- Consulta el Context Broker
- Parámetros:
  - dirección (predeterminada: "localhost")
  - puerto (predeterminado: 1026)
  - consulta (predeterminado: "")
- Devuelve: cadena JSON con resultados de la consulta
publicar_en_CB
- Publica o actualiza entidades en el Context Broker
- Parámetros:
  - dirección (predeterminada: "localhost")
  - puerto (predeterminado: 1026)
  - entity_data (obligatorio: diccionario con información de la entidad)
- Devuelve: cadena JSON con el estado de la operación

Ejemplo de uso

# 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)

Configuración

El servidor se puede configurar modificando los siguientes parámetros en server.py :

Dirección del host
Número de puerto
Configuración de tiempo de espera

Manejo de errores

El servidor incluye un manejo integral de errores para:

Problemas de conectividad de red
Respuestas no válidas del Context Broker
Datos de entidad malformados
Apagado del servidor

Contribuyendo

¡No dudes en enviarnos problemas y solicitudes de mejora!

Licencia

Este proyecto está licenciado bajo la Licencia Apache 2.0.

Integrations