Ejemplo de cliente y servidor JSON-RPC de MCP

Este repositorio contiene un ejemplo sencillo y fácil de usar de un cliente y servidor JSON-RPC inspirado en MCP, implementado en JavaScript. El proyecto demuestra un flujo de comunicación básico utilizando los módulos integrados de Node.js sin dependencias externas.

Descripción general

• Servidor ( server.js ):

  • Escucha en el puerto TCP 4000.

  • Implementa dos métodos JSON-RPC:

    • initialize : Devuelve un objeto de capacidades básicas (que anuncia una herramienta "eco").

    • echo : repite los parámetros proporcionados por el cliente.

• Cliente ( client.js ):

  • Se conecta al servidor en el puerto 4000.

  • Envía una solicitud initialize seguida de una solicitud echo .

  • Registra las respuestas recibidas del servidor.

Related MCP server: Echo MCP Server

Prerrequisitos

• Node.js instalado en su sistema (se recomienda v10 o posterior).

Empezando

Instalación mediante herrería

Para instalar automáticamente el ejemplo de cliente y servidor JSON-RPC de MCP para Claude Desktop a través de Smithery :

npx -y @smithery/cli install @melvincarvalho/mcpjs --client claude

Instalación manual

1. Clonar el repositorio:

   git clone https://github.com/sandy-mount/mcpjs.git
   cd mcp-jsonrpc-example

2. Ejecutar el servidor:

   Abra una ventana de terminal y ejecute:

   node server.js

   Deberías ver un mensaje como:

   Server listening on port 4000

3. Ejecutar el cliente:

   Abra otra ventana de terminal y ejecute:

   node client.js

   El cliente se conectará al servidor, enviará las solicitudes de inicialización y eco, y mostrará las respuestas.

Cómo funciona

• El servidor escucha las conexiones TCP entrantes en el puerto 4000. Cuando recibe un mensaje JSON-RPC (cada uno terminado en una nueva línea), procesa la solicitud:

  • Para el método initialize , devuelve una respuesta JSON-RPC con capacidades básicas e información del servidor.

  • Para el método echo , devuelve los parámetros que se enviaron en la solicitud.

  • Si se solicita un método desconocido, responde con un error JSON-RPC.

• El cliente se conecta al servidor, envía una solicitud initialize JSON-RPC, espera un breve periodo y luego envía una solicitud echo . Las respuestas del servidor se imprimen en la consola.

Archivos

• server.js : la implementación del servidor JSON‑RPC.

• client.js : la implementación del cliente JSON‑RPC.

Personalización

Puedes ampliar este ejemplo:

• Agregar más métodos JSON-RPC al servidor.

• Implementación de manejo y registro de errores adicionales.

• Experimentar con diferentes protocolos de transporte o agregar soporte TLS.

Licencia

Este proyecto está licenciado bajo la Licencia MIT. Consulte el archivo de LICENCIA para más detalles.

Contribuyendo

Siéntete libre de abrir problemas o enviar solicitudes de extracción con mejoras o sugerencias.

¡Feliz codificación!