Ejecutar Model Context Protocol localmente

Usa esta página para ejecutar el servidor MCP TypeScript extraído y probar su herramienta de clima y recurso en MCP Inspector. El servidor se comunica con su cliente a través de entrada y salida estándar, por lo que espera un cliente en lugar de abrir una página de proyecto o puerto de aplicación.

Lo que necesitas primero

Instala Node 24. MCP Inspector requiere Node 22.19 o más reciente, así que Node 24 cumple ese mínimo, mientras que una versión LTS más antigua puede que no inicie la interfaz de pruebas.

Este proyecto no requiere una clave de API ni archivo .env. Los clientes MCP lanzan el servidor como un proceso hijo, por lo que la versión de Node con la que se ejecuta proviene de lo que lo lanza en tu máquina: tu terminal, Inspector o un cliente de escritorio.

JunoLo que necesitas primero Instala Node 24, y eso es todo: sin clave de API, sin archivo .env.

Espera una sorpresa: este servidor nunca abre una página web. Espera silenciosamente a que un cliente le hable.

JunoLo que necesitas primero Node 24 cubre tanto el servidor TypeScript como la versión mínima de Node de Inspector, así que una instalación es suficiente.

El proyecto se comunica a través de stdio en lugar de un puerto HTTP, por lo que no esperes una URL de servidor. La única URL que abrirás es la de Inspector.

JunoLo que necesitas primero El cliente lanza este servidor como un proceso hijo, por lo que la versión de Node y el entorno provienen de lo que lo lanza, no de la carpeta del servidor.

Por eso la instalación de Node en el lado que lo lanza importa aunque el servidor no necesite clave ni abra puerto.

Instalar y reparar el servidor

Abre una terminal en la carpeta del servidor extraído que contiene package.json:

$ cd path-to-your-downloaded-project
$ npm ci
$ npm install --save-dev tsx

El comando final registra tsx, la herramienta que ejecuta archivos TypeScript, que el script "start": "tsx server.ts" extraído espera.

Puedes iniciar el servidor stdio directamente:

$ npm start

Espera un cliente MCP en lugar de imprimir una URL de navegador. Detenlo con Ctrl+C antes de iniciar Inspector.

JunoInstalar y reparar el servidor Ejecuta npm ci, agrega la herramienta tsx que falta para ejecutar archivos TypeScript, luego prueba npm start.

Cuando la terminal se queda callada, nada está mal: el servidor está esperando un cliente. Detenlo con Ctrl+C antes de abrir Inspector.

JunoInstalar y reparar el servidor El script de inicio ya llama a tsx, por lo que registrarlo como dependencia de desarrollo es la reparación más pequeña que perdura.

Un proceso stdio esperando es un inicio exitoso, no un bloqueo, así que no necesitas reiniciarlo.

JunoInstalar y reparar el servidornpm ci instala solo lo que registra el lockfile enviado, y tsx no está en él. Instalar con --save-dev escribe tsx en package.json y el lockfile.

Esa dependencia registrada es lo que permite a un cliente de escritorio lanzar el servidor después con npm exec desde cualquier directorio, sin tocar server.ts.

Pruébalo con MCP Inspector

Desde la misma carpeta del proyecto, ejecuta MCP Inspector oficial:

$ npx @modelcontextprotocol/inspector npx tsx server.ts

El primer npx descarga e inicia Inspector. Inspector luego lanza tu servidor con npx tsx server.ts como su proceso hijo stdio. La interfaz web de Inspector se ejecuta en su propio puerto local, separado de la conexión stdio al servidor. Abre la URL local impresa en la terminal si no se abre automáticamente.

Aprueba deliberadamente la descarga única de paquete

npx puede pedir permiso para instalar MCP Inspector. Confirma que el paquete es @modelcontextprotocol/inspector antes de aceptar. Para uso repetible en equipo, fija una versión revisada en lugar de depender indefinidamente de la versión más reciente.

En Inspector, conéctate al servidor, lista sus herramientas y recursos, y llama la herramienta de clima con una de las entradas usadas en el curso. El capítulo de uso de herramientas explica qué le da a un modelo una definición de herramienta como esta. Deja la terminal abierta mientras pruebas, luego detén Inspector y el servidor hijo con Ctrl+C.

JunoPruébalo con MCP Inspector Ejecuta el comando de Inspector, abre la URL local que imprime, y conéctate. Luego lista las herramientas y recursos y llama la herramienta de clima.

Si npx pide instalar un paquete, verifica que el nombre sea @modelcontextprotocol/inspector antes de aceptar.

JunoPruébalo con MCP Inspector Inspector es el cliente aquí, y lanza server.ts como su hijo stdio.

Verifica el descubrimiento antes de la invocación: si la lista de herramientas está vacía, llamar a cualquier cosa no funcionará, así que mira la terminal primero. Mantén la terminal abierta y detén ambos procesos con Ctrl+C.

JunoPruébalo con MCP Inspector El npx externo ejecuta Inspector y el comando interno define el transporte del servidor hijo. El puerto de la interfaz web de Inspector es separado de ese tubo stdio.

Una vez que el comando interno funciona aquí, la configuración del cliente de escritorio en la siguiente sección es el mismo lanzamiento escrito como comando y argumentos. Fija una versión revisada de Inspector para uso repetible en equipo.

Conecta otro cliente MCP

Un cliente de escritorio necesita un comando ejecutable y argumentos para lanzar el mismo servidor stdio. Primero, copia las rutas absolutas a la carpeta del proyecto extraído y su archivo server.ts. Configura el cliente con este contrato de proceso, reemplazando ambas rutas de ejemplo:

command: npm
arguments:
  - --prefix
  - /absolute/path/to/project
  - exec
  - --
  - tsx
  - /absolute/path/to/project/server.ts

El valor --prefix hace que npm use la dependencia tsx instalada en ese proyecto aunque el cliente de escritorio se inicie desde otro directorio de trabajo. Un cliente configurado para ejecutar tsx por su cuenta, sin npm --prefix frente a él, depende en cambio de una instalación global y de la PATH del cliente, que a menudo difiere de la de tu terminal. Mantén cada argumento como un elemento separado para que las rutas con espacios sigan siendo un valor. No agregues una URL o puerto: este servidor se comunica a través de stdio.

Los formatos de configuración del cliente difieren, así que mapea ese comando y esos argumentos a los campos en las instrucciones de configuración MCP actual del cliente. Reinicia el cliente después de cambiar su configuración. No necesitas otra descarga de proyecto: conéctalo al servidor extraído que ya probaste. El capítulo de agentes cubre el bucle que ejecuta un cliente cuando su modelo usa herramientas como esta.

JunoConecta otro cliente MCP Establece el comando a npm, agrega los argumentos anteriores con ambas rutas absolutas completadas, luego reinicia el cliente.

Estás reutilizando el servidor que Inspector ya probó, así que si funcionó allí, el lado del servidor está bien y cualquier problema está en la configuración del cliente.

JunoConecta otro cliente MCP La sintaxis de configuración varía entre clientes, pero el contrato de proceso sigue siendo el mismo: npm --prefix selecciona el proyecto, y exec -- tsx lanza su servidor TypeScript sobre stdio.

Mapea esas piezas en los nombres de campo que tu cliente usa.

JunoConecta otro cliente MCP Los clientes de escritorio rara vez heredan la PATH de tu terminal, así que un comando tsx desnudo funciona solo donde una instalación global ocurre de estar visible.

Pasando npm con el prefijo, el separador exec, el corredor y la ruta absoluta del servidor como argumentos separados vincula el lanzamiento a la dependencia registrada del proyecto en lugar.

Solución de problemas

tsx: command not found: Ejecuta npm install --save-dev tsx en la carpeta del proyecto. Para un cliente de escritorio, también confirma que su comando es npm y sus argumentos comienzan con --prefix seguido de la ruta absoluta del proyecto.

Inspector rechaza la versión de Node: Instala Node 24, verifica con node --version, y reabre la terminal.

npm start parece bloquearse: Eso es esperado para un servidor stdio esperando un cliente. Usa Inspector para interactuar con él.

Inspector no muestra herramientas: Verifica la terminal para errores de TypeScript o conexión y confirma que el comando final termina con npx tsx server.ts.

JunoSolución de problemas Instala tsx si falta, cambia a Node 24 si Inspector se niega a iniciar, y recuerda que un servidor silencioso está esperando, no roto.

La mayoría de los problemas en esta página son uno de esos tres.

JunoSolución de problemas Mantén apartadas tres capas de fallo: la instalación de tsx, la versión mínima de Node de Inspector, y la conexión stdio en sí.

Lee la terminal antes de asumir que el registro de herramientas falló; el error real generalmente ya está impreso allí.

JunoSolución de problemas Traza la cadena en orden: el proceso Inspector externo, el comando de lanzamiento hijo, la ejecución de TypeScript, luego la inicialización MCP.

Cualquier enlace puede dejar la lista de herramientas vacía, y la salida de la terminal nombra el que se rompió, así que léela antes de reiniciar cualquier cosa.