Cómo instalar un MCP Server: guía paso a paso

Node.js

Si vas a utilizar un servidor basado en TypeScript o JavaScript, necesitarás el entorno solicitado por el proyecto. El SDK oficial TypeScript v2 documenta Node.js 20 o superior para su guía de primer servidor.

Python

Si utilizas un servidor basado en Python, el SDK oficial v2 requiere Python 3.10 o superior.

Gestor de paquetes

Dependiendo del proyecto puedes necesitar npm, npx, uv, uvx o pip.

Una aplicación compatible

Necesitarás un Host compatible con MCP para utilizar el servidor después de instalarlo. Durante el desarrollo puedes probarlo con MCP Inspector.

Paso 1: identifica el servidor

Primero determina qué MCP Server necesitas. El proyecto debería indicar sus requisitos, método de instalación y forma de ejecución.

Paso 2: instala las dependencias

Un servidor Node.js puede utilizar paquetes de npm mientras que uno basado en Python puede utilizar PyPI y herramientas como uv.

Paso 3: ejecuta el servidor

El comando exacto depende de cada implementación. No existe un único comando universal para instalar todos los MCP Servers.

Paso 4: prueba la instalación

Comprueba que el proceso inicia correctamente y que las capacidades esperadas están disponibles.

Paso 5: configura el Host

Una vez probado, registra el servidor en la aplicación que utilizará MCP.

Crear el proyecto

La documentación oficial utiliza Node.js 20 o superior. Crea un proyecto nuevo y prepara el entorno:

mkdir mi-mcp-server
cd mi-mcp-server

npm init -y
npm pkg set type=module

npm install @modelcontextprotocol/server zod tsx

mkdir src

El paquete oficial actual para servidores TypeScript es @modelcontextprotocol/server.

Crear el servidor

Crea src/index.ts con una herramienta sencilla:

import { McpServer } from '@modelcontextprotocol/server';
import { serveStdio } from '@modelcontextprotocol/server/stdio';
import * as z from 'zod/v4';

const server = new McpServer({
  name: 'mi-mcp-server',
  version: '1.0.0'
});

server.registerTool(
  'saludar',
  {
    description: 'Devuelve un saludo personalizado',
    inputSchema: {
      nombre: z.string()
    }
  },
  async ({ nombre }) => ({
    content: [
      {
        type: 'text',
        text: `Hola ${nombre}`
      }
    ]
  })
);

void serveStdio(() => server);

Ejecutar el servidor

npx tsx src/index.ts

En un servidor stdio, el proceso permanece esperando solicitudes del cliente.

Instalar el SDK

El SDK Python v2 requiere Python 3.10 o superior. Para el entorno de desarrollo puedes instalar el paquete con uv o pip.

uv add "mcp[cli]"

También puedes instalarlo utilizando pip:

pip install "mcp[cli]"

Crear el servidor

Crea un archivo llamado server.py:

from mcp.server import MCPServer

mcp = MCPServer("Mi servidor")


@mcp.tool()
def sumar(a: int, b: int) -> int:
    """Suma dos números."""
    return a + b

Ejecutarlo durante el desarrollo

uv run mcp dev server.py

El comando de desarrollo permite iniciar el servidor y abrir MCP Inspector para explorarlo durante las pruebas.

Probar un servidor TypeScript

npx @modelcontextprotocol/inspector npx tsx src/index.ts

El Inspector lanza el comando indicado y proporciona una interfaz para conectarse al servidor y probar sus herramientas.

Probar un servidor Python

uv run mcp dev server.py

Durante el desarrollo puedes revisar las capacidades expuestas por el servidor y comprobar que las llamadas funcionan correctamente.

¿Qué deberías comprobar?

La configuración depende del Host

No existe un archivo universal para registrar servidores MCP en todas las aplicaciones. Cada Host dispone de su propio mecanismo de configuración.

Ejemplo con VS Code

VS Code permite definir servidores MCP mediante .vscode/mcp.json o mediante la configuración de usuario.

{
  "servers": {
    "mi-servidor": {
      "command": "npx",
      "args": [
        "tsx",
        "/ruta/a/src/index.ts"
      ]
    }
  }
}

El comando y los argumentos deben corresponder al servidor realmente instalado.

Ejemplo con un servidor Python

{
  "servers": {
    "mi-servidor-python": {
      "command": "uv",
      "args": [
        "run",
        "mcp",
        "run",
        "/ruta/a/server.py"
      ]
    }
  }
}

La estructura anterior es un ejemplo de registro del proceso. La ruta y los argumentos deben adaptarse a tu proyecto y entorno.

Comprueba el comando directamente

Una forma sencilla de aislar el problema consiste en ejecutar directamente desde la terminal el mismo comando que utiliza el Host.

Si falla en la terminal, el problema está probablemente en el entorno o en el propio servidor. Si funciona en la terminal pero falla dentro del Host, revisa la configuración de la integración.

Configuración

Define explícitamente las variables de entorno, rutas, endpoints y credenciales necesarias.

Permisos mínimos

El proceso debería disponer únicamente de los permisos necesarios para realizar sus funciones.

Logs

Mantén registros suficientes para diagnosticar problemas sin exponer secretos o información sensible.

Dependencias

Mantén controladas las versiones de las dependencias y prueba las actualizaciones antes de utilizarlas en producción.

Monitorización

Si el servidor proporciona acceso a sistemas relevantes, considera métricas, alertas y mecanismos de auditoría.

Primero identifica el servidor y revisa sus requisitos.

Después instala las dependencias necesarias y ejecuta el comando indicado por el proyecto.

Antes de integrarlo con una aplicación de IA, prueba el servidor con MCP Inspector cuando corresponda.

Finalmente registra el comando, argumentos, variables de entorno y permisos en el Host.

Si vas a desarrollar tu propio servidor, puedes utilizar los SDK oficiales actuales para TypeScript o Python.

MCP TypeScript SDK · Crear el primer servidor

MCP TypeScript SDK · @modelcontextprotocol/server

MCP Python SDK · Instalación

MCP Python SDK · Ejecución

VS Code · MCP Servers