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 .

Related MCP server: MCP Framework

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

Instalación mediante herrería

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

1. Bifurcar el repositorio

2. Crea tu rama de funciones ( git checkout -b feature/AmazingFeature )

3. Confirme sus cambios ( git commit -m 'Add some AmazingFeature' )

4. Empujar a la rama ( git push origin feature/AmazingFeature )

5. 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.