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.