MCP - Model Context Protocol en Copilot

Qué es el Model Context Protocol (MCP)

El Model Context Protocol (MCP) es un estándar abierto que permite conectar modelos de IA con herramientas y fuentes de datos externas. En el contexto de VS Code, MCP amplía las capacidades de GitHub Copilot permitiéndole interactuar con bases de datos, APIs, sistemas de archivos, servicios en la nube y cualquier herramienta que implemente el protocolo.

Sin MCP, Copilot solo puede trabajar con el código del proyecto y la información disponible en su modelo base. Con MCP, Copilot puede consultar una base de datos para generar una query, llamar a una API para obtener información actualizada o ejecutar herramientas de desarrollo como linters, formateadores o sistemas de despliegue.

MCP funciona mediante un modelo cliente-servidor. VS Code actúa como cliente MCP y se conecta a servidores MCP que exponen herramientas y recursos. Copilot Agent Mode descubre las herramientas disponibles y las utiliza cuando son relevantes para la tarea solicitada.

MCP es un protocolo abierto mantenido por la comunidad. No es exclusivo de GitHub Copilot ni de VS Code: otros asistentes de IA y editores también pueden implementarlo.

Configurar servidores MCP en VS Code

Archivo mcp.json del proyecto

La forma recomendada de configurar servidores MCP es mediante el archivo .vscode/mcp.json en la raíz del proyecto. Este archivo se comparte con el equipo a través del control de versiones.

{
  "servers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/home/dev/documentos"
      ]
    },
    "postgres": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-postgres",
        "postgresql://localhost:5432/mi_base_datos"
      ]
    }
  }
}

Cada servidor se define con un nombre identificativo y las propiedades:

• command: el ejecutable que inicia el servidor (normalmente npx, node, python o un binario)
• args: argumentos que se pasan al comando, incluyendo configuración específica del servidor

Configuración desde settings.json

Los servidores MCP también se pueden definir en el archivo settings.json del usuario o del workspace:

{
  "mcp": {
    "servers": {
      "github": {
        "command": "npx",
        "args": [
          "-y",
          "@modelcontextprotocol/server-github"
        ],
        "env": {
          "GITHUB_TOKEN": "${env:GITHUB_TOKEN}"
        }
      }
    }
  }
}

La propiedad env permite pasar variables de entorno al servidor. La sintaxis ${env:NOMBRE} referencia variables de entorno del sistema, lo que permite mantener tokens y credenciales fuera del código fuente.

Tipos de servidores disponibles

La comunidad MCP mantiene un catálogo de servidores para herramientas comunes:

• Filesystem: acceso a directorios y archivos del sistema
• PostgreSQL / MySQL / SQLite: consultas y esquemas de bases de datos
• GitHub: repositorios, issues, pull requests y acciones
• Brave Search: búsquedas web en tiempo real
• Fetch: peticiones HTTP a APIs externas
• Docker: gestión de contenedores e imágenes

Cada servidor expone un conjunto de herramientas (tools) que Copilot puede invocar. Por ejemplo, el servidor de PostgreSQL expone herramientas para ejecutar queries, listar tablas y describir esquemas.

Verificar y gestionar servidores MCP

Estado de los servidores

VS Code muestra el estado de los servidores MCP configurados en la interfaz. Para verificar qué servidores están activos:

> MCP: List Servers

El panel muestra cada servidor con su estado (running, stopped o error) y las herramientas que expone. Si un servidor no se inicia correctamente, el panel de salida muestra los mensajes de error del proceso.

Iniciar y detener servidores

Los servidores se inician automáticamente cuando se abre el proyecto que los contiene. Para reiniciar un servidor que ha fallado o reflejar cambios de configuración:

> MCP: Restart Server

Para detener un servidor específico:

> MCP: Stop Server

Herramientas disponibles

Cada servidor MCP registra las herramientas que ofrece. Cuando se trabaja en Copilot Agent Mode, estas herramientas aparecen en la lista de capacidades disponibles. Copilot decide automáticamente cuándo usar cada herramienta según el contexto de la petición.

Por ejemplo, si se pide "muestra las tablas de la base de datos y genera un modelo TypeScript para la tabla de usuarios", Copilot:

• 1. Invoca la herramienta list_tables del servidor PostgreSQL
• 2. Invoca describe_table para obtener el esquema de la tabla de usuarios
• 3. Genera el modelo TypeScript basándose en los campos y tipos obtenidos

Flujos de trabajo con MCP

Consultar bases de datos desde el chat

Con un servidor de base de datos configurado, se pueden hacer consultas directamente desde Copilot Chat:

@workspace Genera una query SQL que obtenga los usuarios activos 
con más de 5 pedidos en el último mes

Copilot usa las herramientas MCP para inspeccionar el esquema real de la base de datos, identificar las tablas y columnas relevantes y generar una query compatible con la estructura existente.

Automatizar tareas con herramientas personalizadas

Los servidores MCP no se limitan a herramientas predefinidas. Se pueden crear servidores personalizados que expongan las operaciones específicas del proyecto:

{
  "servers": {
    "proyecto-tools": {
      "command": "node",
      "args": ["./tools/mcp-server.js"]
    }
  }
}

Un servidor personalizado puede exponer herramientas para desplegar en staging, ejecutar migrations de base de datos, generar reportes o cualquier operación que el equipo necesite automatizar desde Copilot Agent Mode.

Los servidores MCP personalizados se desarrollan en cualquier lenguaje que soporte el protocolo (JavaScript/TypeScript, Python, Go, Rust). La especificación del protocolo está disponible en la documentación oficial de MCP.