Aquí hay un README mejorado con más detalles técnicos basados en el código base:

servidor remoto mcp

Un servidor de Protocolo de Contexto de Modelo (MCP) configurable que carga dinámicamente sus capacidades desde una configuración remota. Esto aprovecha el Protocolo de Contexto de Modelo para crear un servidor local que puede comunicarse con su cliente MCP local.

Descripción general

mcp-remote-server actúa como puente entre los clientes MCP y las API remotas. Analiza una configuración alojada remotamente (especificada mediante MCP_CONTROL_PLANE_URL ) que contiene una lista de herramientas, recursos y solicitudes, cada una de las cuales apunta a puntos finales de API remotas.

Características principales

• Configuración dinámica : las capacidades del servidor se definen a través de una configuración JSON remota

• Actualización automática : la configuración se actualiza automáticamente cada 60 segundos

• Admite todas las primitivas MCP :

  • Herramientas: Ejecutar acciones a través de llamadas API remotas

  • Recursos: Exponer datos remotos como recursos legibles

  • Indicaciones: definir plantillas de indicaciones reutilizables

Formato de configuración

{
  "tools": [{
    "name": "tool-name",
    "description": "Tool description",
    "inputSchema": {
      "type": "object",
      "properties": {
        // JSON Schema for tool inputs
      }
    },
    "handler": "https://api.example.com/tool-endpoint"
  }],
  "resources": [{
    "uri": "resource://identifier",
    "name": "Resource Name",
    "description": "Resource description",
    "mimeType": "application/json",
    "handler": "https://api.example.com/resource-endpoint"
  }],
  "prompts": [{
    "name": "prompt-name",
    "description": "Prompt description",
    "arguments": [{
      "name": "arg-name",
      "description": "Argument description",
      "required": true
    }],
    "handler": "https://api.example.com/prompt-endpoint"
  }]
}

Requisitos de la API del controlador

Los controladores remotos deben devolver respuestas con el formato adecuado:

• Manipuladores de herramientas : devuelven JSON que se convertirá en cadena y se incluirá en una respuesta de la herramienta MCP

• Manejadores de recursos : Devuelven contenido que coincide con el tipo MIME especificado

• Manejadores de avisos : Devuelven una cadena (envuelta automáticamente en un mensaje) o una matriz de mensajes con formato MCP

Related MCP server: MCP-YNU FastMCP Server

Instalación

bun install

Uso

1. Establezca la URL de su plano de control:

export MCP_CONTROL_PLANE_URL="https://your-config-endpoint"

2. Ejecutar el servidor:

bun run index.ts

Limitaciones

• Solo admite puntos finales de controlador HTTP/HTTPS

• La configuración debe ser accesible a través de una solicitud HTTP GET

• Las respuestas del controlador deben ser compatibles con JSON

• Se ejecuta solo localmente (limitación estándar de MCP)

Este proyecto se creó con bun init en bun v1.1.32. Bun es un entorno de ejecución de JavaScript rápido y completo. Elegí Bun porque es rápido y quería probar algo diferente.

Este proyecto también usa Biome para la comprobación de tipos y el análisis de errores. Elegí Biome por la misma razón que Bun: quería algo diferente y me gustaría que JS tuviera una herramienta similar a gofmt . Es un buen comienzo.