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

Related MCP server: Synapse MCP Server

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

1. Clonar este repositorio:

git clone <repository-url>
cd FIWARE_MCP_01

2. 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

1. 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

2. 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

3. 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.