MCP Compatible Server

Servidor MCP Compatible

Servidor MCP con compatibilidad hacia atrás que soporta tanto el protocolo Streamable HTTP moderno (2025-03-26) como el protocolo HTTP+SSE deprecated (2024-11-05).

🚀 Características

Protocolos Soportados

Streamable HTTP (2025-03-26) - Protocolo moderno
- ✅ Resumabilidad de sesiones
- ✅ Event Store para recuperación de eventos
- ✅ Gestión avanzada de sesiones
- ✅ Soporte completo para GET/POST/DELETE
HTTP+SSE (2024-11-05) - Protocolo legacy
- ✅ Notificaciones en tiempo real
- ✅ Compatibilidad con clientes antiguos
- ✅ Soporte para Server-Sent Events

Herramientas Incluidas

🔧 get-server-info - Información del servidor y estadísticas
🧪 test-compatibility - Test de compatibilidad de protocolos
📡 start-notification-stream - Stream de notificaciones periódicas
📨 send-immediate-notification - Notificación inmediata
🔗 test-protocol-connectivity - Test de conectividad

📦 Instalación

# Instalar dependencias
npm install

# Compilar TypeScript
npm run build

# Ejecutar en modo desarrollo
npm run dev

🎯 Uso

Iniciar el Servidor

# Modo desarrollo (con hot reload)
npm run dev

# Modo producción
npm run build && npm start

El servidor estará disponible en http://localhost:3002

Endpoints Disponibles

GET / - Información del servidor
/mcp - Endpoint Streamable HTTP (GET/POST/DELETE)
/sse - Endpoint SSE legacy (GET)
/messages - Endpoint POST legacy (POST)

Ejecutar Tests

# Test básico
npm run test

# Test completo de ambos protocolos
npm run test-both

# Test solo protocolo moderno
npm run test-modern

# Test solo protocolo legacy
npm run test-legacy

🔌 Conexión con Clientes

Protocolo Streamable HTTP (Moderno)

import { Client } from '@modelcontextprotocol/sdk/client/index.js';
import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';

const client = new Client({
  name: 'my-client',
  version: '1.0.0',
}, {
  capabilities: { logging: {} }
});

const transport = new StreamableHTTPClientTransport({
  baseUrl: 'http://localhost:3002/mcp'
});

await client.connect(transport);

Protocolo HTTP+SSE (Legacy)

import { Client } from '@modelcontextprotocol/sdk/client/index.js';
import { SSEClientTransport } from '@modelcontextprotocol/sdk/client/sse.js';

const client = new Client({
  name: 'my-legacy-client',
  version: '1.0.0',
}, {
  capabilities: { logging: {} }
});

const transport = new SSEClientTransport({
  url: 'http://localhost:3002/sse',
  postUrl: 'http://localhost:3002/messages'
});

await client.connect(transport);

🧪 Testing con Postman

Protocolo Streamable HTTP

Inicializar sesión:
POST http://localhost:3002/mcp Content-Type: application/json { "jsonrpc": "2.0", "method": "initialize", "params": { "capabilities": {} }, "id": 1 }
Llamar herramienta:
POST http://localhost:3002/mcp Content-Type: application/json Mcp-Session-Id: <session-id-from-response> { "jsonrpc": "2.0", "method": "tools/call", "params": { "name": "get-server-info", "arguments": {} }, "id": 2 }

Protocolo HTTP+SSE

Establecer stream SSE:
GET http://localhost:3002/sse Accept: text/event-stream
Enviar mensajes:
POST http://localhost:3002/messages?sessionId=<session-id> Content-Type: application/json { "jsonrpc": "2.0", "method": "initialize", "params": { "capabilities": {} }, "id": 1 }

🔧 Desarrollo

Estructura del Proyecto

servidor-compatible/
├── src/
│   ├── server.ts                 # Servidor principal
│   ├── shared/
│   │   └── inMemoryEventStore.ts # Event Store para resumabilidad
│   ├── tools/
│   │   └── notificationTools.ts  # Herramientas de notificación
│   ├── test-client.ts           # Cliente de prueba básico
│   ├── test-modern-client.ts    # Cliente protocolo moderno
│   ├── test-legacy-client.ts    # Cliente protocolo legacy
│   └── test-both-protocols.ts   # Test completo
├── package.json
├── tsconfig.json
└── README.md

Scripts Disponibles

npm run build - Compilar TypeScript
npm run dev - Ejecutar en modo desarrollo
npm run start - Ejecutar en modo producción
npm run test - Test básico
npm run test-both - Test completo de protocolos
npm run test-modern - Test protocolo moderno
npm run test-legacy - Test protocolo legacy

📋 Características Técnicas

Resumabilidad (Solo Protocolo Moderno)

El servidor implementa resumabilidad completa:

Event Store: Almacena eventos para recuperación
Session Management: Gestión de sesiones persistentes
Automatic Reconnection: Reconexión automática con recuperación de estado

Compatibilidad hacia Atrás

Dual Protocol Support: Soporta ambos protocolos simultáneamente
Independent Sessions: Sesiones independientes por protocolo
Legacy Client Support: Soporte completo para clientes antiguos

Gestión de Recursos

Memory Management: Limpieza automática de eventos antiguos
Connection Cleanup: Limpieza automática de conexiones cerradas
Graceful Shutdown: Apagado elegante del servidor

🛡️ Producción

Para uso en producción:

Configurar variables de entorno apropiadas
Usar un proceso manager como PM2
Configurar reverse proxy (nginx/apache)
Implementar logging estructurado
Monitorear rendimiento y memoria

🤝 Contribuir

Fork el proyecto
Crear branch para feature (git checkout -b feature/nueva-funcionalidad)
Commit cambios (git commit -m 'Agregar nueva funcionalidad')
Push al branch (git push origin feature/nueva-funcionalidad)
Crear Pull Request

📄 Licencia

Este proyecto está bajo la licencia MIT. Ver el archivo LICENSE para más detalles.

🔗 Enlaces Útiles

Nota: Este servidor es compatible con ambos protocolos MCP, pero se recomienda usar el protocolo Streamable HTTP moderno para nuevas implementaciones debido a sus características avanzadas de resumabilidad y gestión de sesiones.

This server cannot be installed

security - not tested

license - not found

quality - not tested

How are these scores calculated?

A dual-protocol MCP server that supports both modern Streamable HTTP and legacy HTTP+SSE protocols, providing backward compatibility for clients while offering advanced features like session resumability.

Related MCP Servers

Weaviate MCP Server
kirill-markin
A
security
A
license
A
quality
A simple MCP server that facilitates website fetching through a configurable server platform using stdio or SSE transport, allowing integration with tools like Cursor for streamlined access.
Last updated -
2
35
Python
MIT License
SSE MCP Server
KelvinQiu802
-
security
F
license
-
quality
A server for Model Context Protocol (MCP) that uses Server-Sent Events (SSE) for streaming communication, enabling tools like the HackerNews API to be accessed through a secure HTTP+SSE transport.
Last updated -
23
TypeScript
HTTP OAuth MCP Server
NapthaAI
-
security
A
license
-
quality
A reference implementation for creating an MCP server supporting Streamable HTTP & SSE Transports with OAuth authorization, allowing developers to build OAuth-authorized MCP servers with minimal configuration.
Last updated -
69
TypeScript
MIT License
MCP Tools
starzzzzzzzzzzzzzz
-
security
F
license
-
quality
An MCP (Model Context Protocol) server implementation using HTTP SSE (Server-Sent Events) connections with built-in utility tools including echo, time, calculator, and weather query functionality.
Last updated -
JavaScript

View all related MCP servers