MCP Async Server

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Servidor asíncrono MCP

🚀 Una implementación de servidor de Protocolo de Contexto de Modelo (MCP) de alto rendimiento que muestra procesamiento de tareas asincrónico con seguimiento de estado sólido y manejo de errores.


✨ Características

  • 🔄 Procesamiento de tareas asincrónicas : gestione operaciones de larga duración de manera eficiente
  • 📊 Seguimiento del estado en tiempo real : supervise el progreso de las tareas con soporte de sondeo
  • 🧹 Gestión automática de recursos : limpieza inteligente de tareas y gestión de memoria
  • ⏱️ Manejo de tiempos de espera : tiempos de espera configurables para tareas
  • 🛡️ Manejo robusto de errores : tipos de errores personalizados e informes de errores completos
  • Compatibilidad con TypeScript : seguridad de tipos completa y funciones modernas de JavaScript
  • 🔍 Inspector integrado : depure y pruebe su servidor MCP con facilidad

🚀 Inicio rápido

Prerrequisitos

  • Node.js 20.x o superior
  • npm 9.x o superior

Instalación mediante herrería

Para instalar Async MCP Server para Claude Desktop automáticamente a través de Smithery :

npx -y @smithery/cli install @ViezeVingertjes/example-async-mcp --client claude

Instalación

# Clone the repository git clone https://github.com/ViezeVingertjes/example-async-mcp.git # Navigate to the project directory cd example-async-mcp # Install dependencies npm install # Build the project npm run build

Ejecución del servidor

npm start

Usando el Inspector

npm run inspector

Referencia de API

Herramientas disponibles

process_task

Crea una nueva tarea asincrónica.

{ "name": "process_task", "arguments": { "input": "Hello, World!", "delayMs": 5000, "timeoutMs": 30000 } }
ParámetroTipoRequeridoPor defectoDescripción
aportecadena-La cadena de entrada a procesar
retrasoMsnúmero5000Retraso de procesamiento en milisegundos
tiempo de espera Sra.número30000Tiempo de espera de la tarea en milisegundos

check_task_status

Comprobar el estado de una tarea existente.

{ "name": "check_task_status", "arguments": { "taskId": "550e8400-e29b-41d4-a716-446655440000" } }
ParámetroTipoRequeridoDescripción
ID de tareacadenaEl ID de la tarea a comprobar

Estados de tarea

EstadoDescripción
🕒 pendingTarea creada pero no iniciada
processingLa tarea se está procesando
completeTarea completada con éxito
errorLa tarea falló

⚙️ Configuración

Opciones de configuración clave en src/constants.ts :

export const DEFAULT_TASK_TIMEOUT_MS = 30000; // 30 seconds export const DEFAULT_TASK_DELAY_MS = 5000; // 5 seconds export const DEFAULT_POLL_DELAY_MS = 10000; // 10 seconds export const POLL_INTERVAL_MS = 100; // 100ms export const MAX_TASKS = 1000; // Maximum concurrent tasks

🛠️ Desarrollo

Estructura del proyecto

src/ ├── index.ts # Main server implementation ├── types.ts # TypeScript types and interfaces ├── constants.ts # Configuration constants └── utils.ts # Utility functions

Comandos de desarrollo

# Build the project npm run build # Watch for changes npm run watch # Run tests npm test # Run inspector npm run inspector

📝 Licencia

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


-
security - not tested
A
license - permissive license
-
quality - not tested

Este servidor implementa el Protocolo de Contexto de Modelo (MCP) para manejar tareas asincrónicas con seguimiento de estado en tiempo real, manejo robusto de errores y administración automática de recursos.

  1. ✨ Features
    1. 🚀 Quick Start
      1. Prerequisites
      2. Installing via Smithery
      3. Installation
      4. Running the Server
      5. Using the Inspector
    2. 📖 API Reference
      1. Available Tools
      2. Task States
    3. ⚙️ Configuration
      1. 🛠️ Development
        1. Project Structure
        2. Development Commands
      2. 📝 License
        ID: k2os9maqr0