Constructo del agente

Podemos cargar cualquier cosa, desde ropa hasta equipo, armas, simulacros de entrenamiento, todo lo que necesitemos. - Matrix (1999)

Agent Construct es una implementación de servidor del Protocolo de Contexto de Modelo (MCP) que estandariza el acceso de las aplicaciones de IA a las herramientas y al contexto. Al igual que Construct en Matrix proporcionaba a los operadores acceso instantáneo a cualquier equipo que necesitaran, Agent Construct proporciona una interfaz estandarizada para que los modelos de IA accedan a herramientas y datos mediante la especificación MCP.

Basado en la especificación del Protocolo de Contexto de Modelo , actúa como un centro central que gestiona el descubrimiento, la ejecución y la gestión del contexto de herramientas para aplicaciones de IA. Proporciona una forma robusta y escalable de exponer capacidades a modelos de IA mediante un protocolo estandarizado. Además, ofrece una configuración y una estructura de herramientas simplificadas para facilitar la incorporación de nuevas capacidades. Se incluye una herramienta de ejemplo para buscar en la web con Gemini.

Características principales

Implementación del protocolo MCP

• Cumplimiento total de MCP : implementación completa de la especificación del Protocolo de contexto de modelo

• Descubrimiento de herramientas : mecanismo dinámico de registro y descubrimiento de herramientas

• Comunicación estandarizada : implementa los patrones de comunicación de MCP para la interacción de herramientas

Arquitectura del servidor

• FastAPI Backend : Implementación de servidor asincrónico de alto rendimiento

• Transmisión de eventos : actualizaciones en tiempo real mediante eventos enviados por el servidor (SSE)

• Diseño modular : separación clara entre el manejo del protocolo central y las implementaciones de herramientas

• Sistema de manejo : arquitectura de manejo de solicitudes extensible para diferentes operaciones MCP

• Limitación de velocidad basada en herramientas : deje que el servidor gestione su limitación de velocidad configurable por herramienta.

Características de desarrollo

• Sistema decorador de herramientas : una forma sencilla de exponer nuevas herramientas a través de MCP

• Registro y monitoreo : Sistema de registro integral para depuración y monitoreo

• Gestión de la configuración : configuración basada en el entorno con valores predeterminados seguros

• Marco de pruebas : Amplio conjunto de pruebas para el cumplimiento del protocolo

• Framework del agente amigable : se incluyen ejemplos de implementación para clientes personalizados o frameworks como smolagents.

Related MCP server: AgentMode

Empezando

Prerrequisitos

• Python 3.8 o superior

• gestor de paquetes pip

Instalación

1. Clonar el repositorio:

   git clone https://github.com/yourusername/agent-construct.git
   cd agent-construct

2. Instalar dependencias:

   pip install -r requirements.txt

3. Configurar variables de entorno: Cree un archivo .env en el directorio raíz con las siguientes variables:

   # Server Configuration
   SERVER_HOST=localhost
   SERVER_PORT=8000
   
   # MCP Protocol Settings
   MCP_VERSION=1.0
   TOOL_DISCOVERY_ENABLED=true
   
   # Security Settings
   ENABLE_AUTH=false  # Enable for production

4. Ejecutar el servidor:

   python -m mcp_server

Arquitectura central

mcp_server/
├── core/               # Core MCP protocol implementation
│   ├── server.py      # Main server implementation
│   ├── protocol.py    # MCP protocol handlers
│   └── context.py     # Context management
├── handlers/          # MCP operation handlers
│   ├── discovery.py   # Tool discovery
│   ├── execution.py   # Tool execution
│   └── context.py     # Context operations
├── utils/            # Utility functions
│   ├── logging.py    # Logging configuration
│   ├── security.py   # Security utilities
│   └── config.py     # Configuration management
└── __main__.py       # Server entry point

Características del protocolo MCP

Descubrimiento de herramientas

• Sistema dinámico de registro de herramientas

• Anuncio de capacidad de la herramienta

• Gestión de versiones

• Metadatos y documentación de la herramienta

Gestión del contexto

• Almacenamiento y recuperación de contexto eficiente

• Delimitación y aislamiento del contexto

• Actualizaciones de contexto en tiempo real

• Opciones de persistencia del contexto

Patrones de comunicación

• Solicitud/respuesta sincrónica

• Eventos enviados por el servidor para actualizaciones

• Respuestas en streaming

• Manejo y recuperación de errores

Mejoras futuras

Extensiones de protocolo

• [ ] Funciones avanzadas de gestión de contexto

• [ ] Extensiones de protocolo personalizadas

• [ ] Sistema de complementos para manejadores de protocolo

Seguridad

• [ ] Autenticación y autorización

• [ ] Control de acceso a herramientas

• [-] Limitación de velocidad y gestión de cuotas

• [ ] Registro de auditoría

• [ ] Cifrado de extremo a extremo

Actuación

• [ ] Optimización de la ejecución de herramientas

• [ ] Almacenamiento en caché de contexto

• [ ] Equilibrio de carga

• [ ] Cola de solicitudes

• [ ] Gestión de recursos

Desarrollo

• [ ] Explorador de protocolos interactivo

• [ ] SDK de desarrollo de herramientas

• [ ] Herramientas de prueba de cumplimiento de protocolo

• [ ] Panel de control de monitorización del rendimiento

Contribuyendo

¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios. Para cambios importantes, primero abra una incidencia para comentar qué desea cambiar.

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

Expresiones de gratitud

• Protocolo de contexto del modelo para la especificación del protocolo

• FastAPI para el excelente marco web

• La comunidad de código abierto para diversas herramientas y bibliotecas utilizadas en este proyecto