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

Establezca la URL de su plano de control:

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

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.