Intro to Model Context ProtocolEjecutar Model Context Protocol localmente
Usa esta página para ejecutar el servidor MCP de clima extraído en tu computadora y llamar su herramienta de clima desde MCP Inspector. Dos cosas difieren de lo que podrías esperar: el script de inicio necesita una herramienta que el proyecto olvidó listar, y el servidor nunca abre una página propia. Se comunica con el programa que lo inicia, a través de la entrada y salida de la terminal, así que lo pruebas con Inspector, que lo inicia por ti y te da una página para hacer clic.
Lo que necesitas primero
Instala Node.js 24, que incluye npm. MCP Inspector necesita Node 22.19 o más nuevo, y Node 24 está cómodamente por encima de eso.
Verifica la versión. La tuya puede ser más nueva:
$ node --version
v24.18.0No necesitas ninguna clave de API ni archivo .env: los datos del clima están escritos en el código del servidor.
node --version imprima una versión que comience con 24 o superior. Esa es la lista completa: sin clave, sin archivo .env. Instala los paquetes y agrega tsx
Abre una terminal en la carpeta del proyecto extraído. Es la que contiene package.json y server.ts:
$ cd path-to-your-extracted-projectEl script de inicio del proyecto ejecuta tsx server.ts. tsx es la herramienta que ejecuta un archivo TypeScript directamente, pero package.json no la lista, así que una instalación normal la deja fuera y npm start se detiene con sh: tsx: command not found. Instala los paquetes listados, luego agrega tsx:
$ npm ci
added 91 packages, and audited 92 packages in 3s
…
$ npm install --save-dev tsx
added 3 packages, and audited 95 packages in 7s
…npm también puede reportar vulnerabilidades y sugerir npm audit fix. Déjalas por ahora. También puede imprimir una advertencia que comience con npm warn allow-scripts y nombre esbuild; eso no impide que tsx funcione.
package.json, ejecuta npm ci, luego npm install --save-dev tsx. Cada uno reporta cuántos paquetes agregó. Si npm dice que no encuentra package.json, estás en la carpeta equivocada.
Verifica que el servidor inicie
Inicia el servidor una vez por sí solo:
$ npm start
> [email protected] start
> tsx server.ts
🌤️ Weather MCP Server Started!
🛠️ Tool: getWeatherDataByCityName
📚 Resource: weather://cities
🏙️ Supported Cities: New York, London
✅ Server ready!Después de Server ready! la terminal se queda callada. Ese es un servidor que funciona: está esperando que un programa le envíe un mensaje, y nunca imprime una dirección para abrir. Detenlo con Ctrl+C antes de que inicies Inspector.
npm start y espera a que aparezca Server ready!. Nada más sucederá, y nada debería: presiona Ctrl+C y continúa con Inspector. Llama la herramienta de clima en MCP Inspector
Desde la misma carpeta del proyecto, ejecuta el MCP Inspector oficial, seguido por el comando que inicia tu servidor:
$ npx @modelcontextprotocol/inspector npx tsx server.tsLa primera vez, npx pregunta antes de descargar Inspector. Verifica que el paquete sea @modelcontextprotocol/inspector, luego escribe y:
Need to install the following packages:
@modelcontextprotocol/[email protected]
Ok to proceed? (y)Inspector imprime su dirección y la abre en tu navegador:
Starting MCP inspector...
…
MCP Inspector Web is up and running at:
http://127.0.0.1:6274?MCP_INSPECTOR_API_TOKEN=…
…
Opening browser...Si no se abre ningún navegador, copia la dirección completa, incluido el token, en uno.
La página lista un servidor, npx, marcado como Disconnected. Ignora la nota Read-only session arriba de él. Activa el interruptor junto al servidor: Inspector inicia tu servidor y la etiqueta cambia a Connected. Luego:
- Abre Tools en la parte superior y selecciona
getWeatherDataByCityName. - Escribe
New Yorken el campo city y haz clic en Execute Tool. - El resultado aparece bajo Results:
{
"temp": "22°C",
"forecast": "Partly cloudy with a breeze"
}London también funciona. Cualquier otra ciudad devuelve el mensaje Weather data not available for this city del curso, lo que significa que la herramienta funciona como está escrita. El capítulo de uso de herramientas explica qué le da una herramienta como esta a un modelo.
Resources lista weather://cities, pero seleccionarlo muestra Read Error e Invalid URL. Eso viene de cómo el código de la lección registra el recurso, no de tu configuración; la herramienta es la parte que debes probar.
Cuando termines, presiona Ctrl+C en la terminal. Eso detiene Inspector y el servidor que inició.
y si npx pregunta, y activa el servidor en la página que se abre. Luego ve a Tools, elige la herramienta de clima, escribe New York y haz clic en Execute Tool. Si la etiqueta dice Failed en lugar de Connected, abre la pestaña Console de Inspector a la derecha y busca la línea que comienza con Error.
Conecta otro cliente MCP
Un cliente MCP de escritorio también inicia el servidor, pero desde su propia carpeta de trabajo, así que necesita rutas completas. Copia la ruta absoluta de la carpeta del proyecto extraído, luego dale al cliente este comando y estos argumentos, con ambas rutas de ejemplo reemplazadas:
command: npm
arguments:
- --prefix
- /absolute/path/to/project
- exec
- --
- tsx
- /absolute/path/to/project/server.ts--prefix le dice a npm qué tsx del proyecto usar, sin importar desde dónde inicia el cliente. Mantén cada argumento como un elemento separado, así una ruta que contenga espacios permanece como un valor, y no agregues URL ni puerto.
Cada cliente nombra estos campos de forma diferente, así que pon el comando y los argumentos donde sus instrucciones de configuración MCP digan, luego reinicia el cliente. No necesitas ninguna descarga adicional: este es el servidor que ya probaste. El capítulo de agentes cubre el bucle que ejecuta un cliente cuando su modelo usa una herramienta como esta.
npm, agrega los seis argumentos con la ruta de tu proyecto en ambos lugares, y reinicia el cliente. El servidor ya funcionó en Inspector, así que si el cliente no puede alcanzarlo, verifica primero las rutas en su configuración.
Solución de problemas
npm start dice sh: tsx: command not found: tsx aún no está instalado en el proyecto. Ejecuta npm install --save-dev tsx en la carpeta del proyecto. Para un cliente de escritorio, también verifica que su comando sea npm y sus argumentos comiencen con --prefix y la ruta absoluta del proyecto.
Inspector dice @modelcontextprotocol/inspector v1 is deprecated: Tu Node es más antiguo que 22.19, así que npx obtuvo el Inspector antiguo. Instala Node 24, abre una nueva terminal, verifica node --version, y ejecuta el comando de Inspector de nuevo.
El servidor muestra Failed, e Inspector's Console tab dice Cannot find module terminando en server.ts: Inspector se inició fuera de la carpeta del proyecto. Detenlo con Ctrl+C, cd a la carpeta que contiene server.ts, y ejecuta el comando de nuevo.