Servidor MCP de Fledge
Este es un servidor de Protocolo de Contexto de Modelo (MCP) que conecta la funcionalidad de Fledge con Cursor AI, lo que permite que la IA interactúe con las instancias de Fledge a través de comandos de lenguaje natural.
Prerrequisitos
- Fledge instalado localmente o accesible a través de API (predeterminado: http://localhost:8081 )
- Cursor AI instalado
- Python 3.8+
Instalación
- Clonar este repositorio:
git clone https://github.com/Krupalp525/fledge-mcp.git
cd fledge-mcp
- Instalar las dependencias:
pip install -r requirements.txt
Ejecución del servidor
- Asegúrese de que Fledge se esté ejecutando:
- Inicie el servidor MCP:
Para una operación segura con autenticación de clave API:
python secure_mcp_server.py
- Verifique que esté funcionando accediendo al punto final de salud:
curl http://localhost:8082/health
Debería recibir "Fledge MCP Server se está ejecutando" como respuesta.
Conectando al cursor
- En Cursor, vaya a Configuración > Servidores MCP
- Agregar un nuevo servidor:
- Para el servidor seguro, configure el encabezado "X-API-Key" con el valor del archivo api_key.txt que se genera cuando se inicia el servidor seguro.
- Pruébelo: abra Cursor's Composer (Ctrl+I), escriba "Verificar si la API de Fledge es accesible" y la IA debería llamar a la herramienta
validate_api_connection .
Herramientas disponibles
Acceso y gestión de datos
- get_sensor_data : obtiene datos del sensor de Fledge con filtrado opcional por rango de tiempo y límite
- list_sensors : Lista todos los sensores disponibles en Fledge
- ingest_test_data : Ingesta datos de prueba en Fledge, con recuento de lotes opcional
Control de servicio
- get_service_status : Obtener el estado de todos los servicios de Fledge
- start_stop_service : Iniciar o detener un servicio Fledge por tipo
- update_config : Actualizar los parámetros de configuración de Fledge
Generación de código frontend
- generate_ui_component : Genera componentes React para la visualización de datos de Fledge
- fetch_sample_frontend : Obtenga plantillas de interfaz de usuario de muestra para diferentes marcos
- suggests_ui_improvements : Obtenga sugerencias impulsadas por IA para mejorar el código de la interfaz de usuario
Transmisión de datos en tiempo real
- subscribe_to_sensor : Configurar una suscripción para actualizaciones de datos del sensor
- get_latest_reading : Obtener la lectura más reciente de un sensor específico
Depuración y validación
- validate_api_connection : Comprueba si la API de Fledge es accesible
- simulator_frontend_request : prueba solicitudes de API con diferentes métodos y cargas útiles
Documentación y esquema
- get_api_schema : obtener información sobre los puntos finales de la API de Fledge disponibles
- list_plugins : Lista de complementos de Fledge disponibles
Funciones avanzadas asistidas por IA
- generate_mock_data : Genera datos simulados de sensores realistas para realizar pruebas.
Probando la API
Puede probar el servidor utilizando los scripts de prueba incluidos:
# For standard server
python test_mcp.py
# For secure server with API key
python test_secure_mcp.py
Opciones de seguridad
El servidor seguro (secure_mcp_server.py) agrega autenticación de clave API:
- En la primera ejecución, genera una clave API almacenada en api_key.txt
- Todas las solicitudes deben incluir esta clave en el encabezado X-API-Key
- El punto final de verificación de estado permanece accesible sin autenticación
Solicitudes de API de ejemplo
# Validate API connection
curl -X POST -H "Content-Type: application/json" -d '{"name": "validate_api_connection"}' http://localhost:8082/tools
# Generate mock data
curl -X POST -H "Content-Type: application/json" -d '{"name": "generate_mock_data", "parameters": {"sensor_id": "temp1", "count": 5}}' http://localhost:8082/tools
# Generate React chart component
curl -X POST -H "Content-Type: application/json" -d '{"name": "generate_ui_component", "parameters": {"component_type": "chart", "sensor_id": "temp1"}}' http://localhost:8082/tools
# For secure server, add API key header
curl -X POST -H "Content-Type: application/json" -H "X-API-Key: YOUR_API_KEY" -d '{"name": "list_sensors"}' http://localhost:8082/tools
Ampliación del servidor
Para agregar más herramientas:
- Agregue la definición de la herramienta a
tools.json - Implementar el controlador de herramientas en
mcp_server.py y secure_mcp_server.py
Consideraciones de producción
Para la implementación de producción:
- Utilice HTTPS
- Implementar detrás de un proxy inverso como Nginx
- Implementar una autenticación más robusta (JWT, OAuth)
- Añadir limitación de velocidad
- Configurar el almacenamiento de datos persistente para las suscripciones
Implementación en Smithery.ai
El servidor Fledge MCP se puede implementar en Smithery.ai para mejorar la escalabilidad y la disponibilidad. Siga estos pasos para la implementación:
- Prerrequisitos
- Docker instalado en su máquina local
- Una cuenta de Smithery.ai
- La herramienta CLI de Smithery instalada
- Construir e implementar
# Build the Docker image
docker build -t fledge-mcp .
# Deploy to Smithery.ai
smithery deploy
- Configuración El archivo
smithery.json contiene la configuración para su implementación:- Transporte de WebSocket en el puerto 8082
- URL de API de Fledge configurable
- Definiciones y parámetros de herramientas
- Configuración de tiempo de espera
- Variables de entorno Configure las siguientes variables de entorno en su panel de Smithery.ai:
FLEDGE_API_URL : Su punto final de la API de FledgeAPI_KEY : Su clave API segura (si usa el modo seguro)
- Verificación Después de la implementación, verifique que su servidor esté funcionando:
smithery status fledge-mcp
- Monitoreo Monitoree su implementación a través del panel de Smithery.ai:
- Registros en tiempo real
- Métricas de rendimiento
- Seguimiento de errores
- Uso de recursos
- Actualización Para actualizar su implementación:
# Build new image
docker build -t fledge-mcp .
# Deploy updates
smithery deploy --update
Compatibilidad con el protocolo JSON-RPC
El servidor implementa el Protocolo de Contexto de Modelo (MCP) mediante JSON-RPC 2.0 sobre WebSocket. Se admiten los siguientes métodos:
- inicializar
{
"jsonrpc": "2.0",
"method": "initialize",
"params": {},
"id": "1"
}
{
"jsonrpc": "2.0",
"result": {
"serverInfo": {
"name": "fledge-mcp",
"version": "1.0.0",
"description": "Fledge Model Context Protocol (MCP) Server",
"vendor": "Fledge",
"capabilities": {
"tools": true,
"streaming": true,
"authentication": "api_key"
}
},
"configSchema": {
"type": "object",
"properties": {
"fledge_api_url": {
"type": "string",
"description": "Fledge API URL",
"default": "http://localhost:8081/fledge"
}
}
}
},
"id": "1"
}
- herramientas/lista
{
"jsonrpc": "2.0",
"method": "tools/list",
"params": {},
"id": "2"
}
- herramientas/llamada
{
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"name": "get_sensor_data",
"parameters": {
"sensor_id": "temp1",
"limit": 10
}
},
"id": "3"
}
Códigos de error
El servidor sigue los códigos de error estándar JSON-RPC 2.0:
- -32700: Error de análisis
- -32600: Solicitud no válida
- -32601: Método no encontrado
- -32602: Parámetros no válidos
- -32000: Error del servidor