MCPServer
El MCPServer es un componente que actúa como punto central para la ejecución y gestión de herramientas dentro del ecosistema Nappai. Su función principal es recibir una lista de herramientas y argumentos, ejecutar las tareas correspondientes y devolver los resultados de manera estructurada, facilitando la integración de procesos automatizados en tu dashboard.
¿Cómo funciona?
El componente no realiza operaciones externas ni llama a APIs externas. Internamente, toma la lista de herramientas que le envías (el input Tools) y los parámetros de entrada (el input args). Luego, utiliza la lógica interna de Nappai para ejecutar cada herramienta con los argumentos proporcionados. Los resultados se empaquetan en dos salidas distintas:
- ToolResult: contiene los resultados de cada herramienta ejecutada.
- ToolsConnected: ofrece un resumen de las herramientas que se conectaron y están disponibles para usar.
Todo el procesamiento ocurre localmente dentro del servidor de Nappai, por lo que no necesitas preocuparte por configuraciones de red o autenticaciones externas.
Entradas
Campos de Entrada
- Tools: Lista de herramientas que deseas ejecutar. Puedes introducirlas manualmente o conectar la salida de otro componente que genere esta lista.
- args: Texto con los argumentos que se pasarán a las herramientas. Se puede escribir directamente o usar la salida de otro componente para pasar parámetros dinámicos.
Salidas
- ToolResult: Resultado de la ejecución de las herramientas. Este valor puede ser usado en otros componentes para tomar decisiones o mostrar información al usuario.
- ToolsConnected: Información sobre las herramientas que están conectadas y disponibles. Útil para verificar que todas las dependencias están correctamente enlazadas antes de iniciar un flujo de trabajo.
Ejemplo de Uso
Supongamos que quieres ejecutar una herramienta de análisis de datos llamada DataAnalyzer con un conjunto de parámetros específicos:
- Configura el input Tools con el nombre de la herramienta:
DataAnalyzer
. - Define los argumentos en el input args, por ejemplo:
dataset = "sales_2024.csv"analysis_type = "trend"
- Conecta la salida ToolResult a un componente de visualización para mostrar los resultados en tu dashboard.
Este flujo sencillo permite que cualquier usuario sin conocimientos técnicos pueda ejecutar análisis complejos con solo arrastrar y soltar componentes.
Componentes Relacionados
- MCPClient – Cliente que se comunica con el servidor MCP para enviar y recibir datos.
- MCPTool – Herramienta individual que puede ser gestionada por el MCPServer.
- MCPWorkflow – Orquestador de flujos que utiliza MCPServer como nodo central.
Consejos y Mejores Prácticas
- Verifica la lista de herramientas antes de ejecutar el flujo para evitar errores de ejecución.
- Utiliza la salida ToolsConnected para depurar y confirmar que todas las dependencias están disponibles.
- Mantén los argumentos claros y estructurados (por ejemplo, en formato JSON) para facilitar la lectura y el mantenimiento.
Consideraciones de Seguridad
- Asegúrate de que los datos sensibles (contraseñas, tokens, etc.) se pasen a través de canales seguros y no se expongan en los inputs de texto plano.
- Revisa los permisos de las herramientas conectadas para evitar ejecuciones no autorizadas.