Puerto TypeScript del agente MCP
Descripción general
El puerto TypeScript del agente MCP (Protocolo de Contexto de Modelo) es una implementación robusta y segura de tipos del sistema de agentes MCP. Proporciona un marco flexible para crear agentes inteligentes con reconocimiento de contexto y funciones avanzadas de gestión de flujos de trabajo, registro y ejecución.
Este es un puerto TypeScript del marco MCP Agent original de lastmile-ai .
Características
- 🚀 Arquitectura modular
- Implementación completa de TypeScript
- Diseño flexible y extensible
- Interfaces de tipo seguro
- 📊 Gestión avanzada del flujo de trabajo
- Ejecución del flujo de trabajo basado en pasos
- Procesamiento de tareas concurrentes
- Seguimiento detallado del contexto
- 🔍 Potente sistema de registro
- Niveles de registro configurables
- Registro rico en contexto
- Capacidades de exportación de registros
- 🧰 Ejecutor Flexible
- Cola de tareas
- Manejo del tiempo de espera
- Gestión de tareas concurrentes
- 🖥️ Soporte CLI
- Interfaz de línea de comandos
- Gestión sencilla de agentes
Instalación
Para instalar MCP Agent TypeScript Port para Claude Desktop automáticamente a través de Smithery :
npx -y @smithery/cli install @waldzellai/mcp-agent-ts --client claude
Instalación manual
npm install @waldzell/mcp-agent-ts
Inicio rápido
Creación de un flujo de trabajo
import { BaseWorkflow } from '@waldzell/mcp-agent-ts';
class MyDataProcessingWorkflow extends BaseWorkflow {
constructor() {
super('my-workflow', 'Data Processing');
this.addStep({
id: 'extract',
name: 'Data Extraction',
execute: async (context) => {
// Implement data extraction logic
return { data: ['item1', 'item2'] };
}
});
this.addStep({
id: 'transform',
name: 'Data Transformation',
execute: async (context) => {
// Implement data transformation logic
return { transformedData: ['ITEM1', 'ITEM2'] };
}
});
}
}
async function runWorkflow() {
const workflow = new MyDataProcessingWorkflow();
const results = await workflow.execute();
console.log(results);
}
Explotación florestal
import { debug, info, warn, error } from '@waldzell/mcp-agent-ts';
// Log with different levels
debug('Debugging information', { userId: 123 });
info('System started');
warn('Potential issue detected');
error('Critical error occurred');
Uso de la CLI
# Start the MCP Agent
npx mcp-agent start
# List available tools
npx mcp-agent list-tools
# Set log level
npx mcp-agent log-level debug
Uso del ejecutor
import { BaseExecutor, Task } from '@waldzell/mcp-agent-ts';
const executor = new BaseExecutor({
maxConcurrentTasks: 3,
timeout: 60000 // 1-minute timeout
});
const task: Task = {
id: 'example-task',
name: 'Sample Task',
execute: async () => {
// Task implementation
return 'Task completed';
}
};
await executor.enqueueTask(task);
Configuración
El agente MCP se puede configurar a través de:
- Variables de entorno
- Archivos de configuración
- Configuración programática
Estado de desarrollo
🚧 Desarrollo en etapa temprana 🚧
Esta es una versión preliminar y aún no está completa. ¡Agradecemos sus contribuciones y comentarios!
Proyecto original
Agente MCP original: lastmile-ai/mcp-agent
Contribuyendo
- Bifurcar el repositorio
- Crea tu rama de funciones (
git checkout -b feature/AmazingFeature ) - Confirme sus cambios (
git commit -m 'Add some AmazingFeature' ) - Empujar a la rama (
git push origin feature/AmazingFeature ) - Abrir una solicitud de extracción
Licencia
Este proyecto sigue la licencia del proyecto MCP Agent original, que se encuentra aquí .
Expresiones de gratitud
Un agradecimiento especial a los desarrolladores originales del Agente MCP por crear un marco innovador para el desarrollo de agentes de IA.