Servidor de conversaciones MCP
Implementación de un servidor de Protocolo de Contexto de Modelo (MCP) para gestionar conversaciones con los modelos de lenguaje de OpenRouter. Este servidor proporciona una interfaz estandarizada para que las aplicaciones interactúen con diversos modelos de lenguaje mediante un sistema unificado de gestión de conversaciones.
Características
- Compatibilidad con el protocolo MCP
- Cumplimiento total del protocolo MCP
- Gestión y descubrimiento de recursos
- Modelo de interacción basado en herramientas
- Soporte de respuesta en streaming
- Manejo y recuperación de errores
- Integración con OpenRouter
- Compatibilidad con todos los modelos de OpenRouter
- Respuestas de transmisión en tiempo real
- Conteo automático de tokens
- Gestión de ventanas de contexto del modelo
- Los modelos disponibles incluyen:
- Claude 3 Opus
- Soneto Claude 3
- Llama 2 70B
- Y muchos más del catálogo de OpenRouter
- Gestión de conversaciones
- Crear y gestionar múltiples conversaciones
- Soporte para mensajes del sistema
- Seguimiento del historial de mensajes
- Monitoreo del uso de tokens
- Filtrado y búsqueda de conversaciones
- Soporte de transmisión
- Transmisión de mensajes en tiempo real
- Manejo de respuestas fragmentadas
- Conteo de fichas
- Persistencia del sistema de archivos
- Persistencia del estado de la conversación
- Ubicación de almacenamiento configurable
- Gestión automática del estado
Instalación
npm install mcp-conversation-server
Configuración
Configuración
Toda la configuración del servidor de conversaciones MCP ahora se proporciona mediante YAML. Actualice el archivo config/models.yaml con su configuración. Por ejemplo:
# MCP Server Configuration
openRouter:
apiKey: "YOUR_OPENROUTER_API_KEY" # Replace with your actual OpenRouter API key.
persistence:
path: "./conversations" # Directory for storing conversation data.
models:
# Define your models here
'provider/model-name':
id: 'provider/model-name'
contextWindow: 123456
streaming: true
temperature: 0.7
description: 'Model description'
# Default model to use if none specified
defaultModel: 'provider/model-name'
Configuración del servidor
El servidor de conversaciones MCP ahora carga toda su configuración desde el archivo YAML. En su aplicación, puede cargar la configuración de la siguiente manera:
const config = await loadModelsConfig(); // Loads openRouter, persistence, models, and defaultModel settings from 'config/models.yaml'
Nota: Las variables de entorno ya no son necesarias ya que toda la configuración se proporciona a través del archivo YAML.
Uso
Configuración básica del servidor
import { ConversationServer } from 'mcp-conversation-server';
const server = new ConversationServer(config);
server.run().catch(console.error);
Herramientas disponibles
El servidor expone varias herramientas MCP:
- crear conversación
{
provider: 'openrouter', // Provider is always 'openrouter'
model: string, // OpenRouter model ID (e.g., 'anthropic/claude-3-opus-20240229')
title?: string; // Optional conversation title
}
- enviar mensaje
{
conversationId: string; // Conversation ID
content: string; // Message content
stream?: boolean; // Enable streaming responses
}
- listas de conversaciones
{
filter?: {
model?: string; // Filter by model
startDate?: string; // Filter by start date
endDate?: string; // Filter by end date
}
}
Recursos
El servidor proporciona acceso a varios recursos:
- conversación://{id}
- Acceder a detalles específicos de la conversación
- Ver historial de mensajes
- Comprobar metadatos de la conversación
- conversación://lista
- Listar todas las conversaciones activas
- Filtrar conversaciones por criterios
- Ordenar por actividad reciente
Desarrollo
Edificio
Ejecución de pruebas
Depuración
El servidor proporciona varias funciones de depuración:
- Registro de errores
- Todos los errores se registran con seguimientos de pila.
- Seguimiento del uso de tokens
- Monitoreo del límite de velocidad
- Inspector de MCPUtilice el Inspector MCP para:
- Ejecución de la herramienta de prueba
- Ver el contenido del recurso
- Monitorear el flujo de mensajes
- Validar el cumplimiento del protocolo
- Validación del proveedor
await server.providerManager.validateProviders();
- Validez de la clave API
- Disponibilidad del modelo
- Estado del límite de velocidad
Solución de problemas
Problemas comunes y soluciones:
- Problemas de conexión de OpenRouter
- Verifique que su clave API sea válida
- Consulte los límites de velocidad en el panel de control de OpenRouter
- Asegúrese de que el ID del modelo sea correcto
- Monitorear el uso del crédito
- Errores de transmisión de mensajes
- Verificar la compatibilidad con la transmisión de modelos
- Comprobar la estabilidad de la conexión
- Monitorear los límites de tokens
- Manejar la configuración del tiempo de espera
- Errores del sistema de archivos
- Comprobar los permisos del directorio
- Verificar la configuración de la ruta
- Monitorizar el espacio en disco
- Gestionar acceso concurrente
Contribuyendo
- Bifurcar el repositorio
- Crear una rama de características
- Confirme sus cambios
- Empujar hacia la rama
- Crear una solicitud de extracción
Licencia
Licencia ISC