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.
Empezando
Prerrequisitos
- Python 3.8 o superior
- gestor de paquetes pip
Instalación
- Clonar el repositorio:
git clone https://github.com/yourusername/agent-construct.git
cd agent-construct
- Instalar dependencias:
pip install -r requirements.txt
- 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
- Ejecutar el servidor:
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