Raíces

Comprendiendo las Roots en MCP

Las Roots son un concepto en MCP que define los límites donde los servidores pueden operar. Proporcionan una forma para que los clientes informen a los servidores sobre los recursos relevantes y sus ubicaciones.

¿Qué son las Roots?

Una root es una URI que un cliente sugiere que un servidor debe enfocarse. Cuando un cliente se conecta a un servidor, declara con qué Roots debe trabajar el servidor. Aunque se utilizan principalmente para rutas de sistemas de archivos, las Roots pueden ser cualquier URI válida, incluyendo URLs HTTP.

Por ejemplo, las Roots podrían ser:

file:///home/user/projects/myapp
https://api.example.com/v1

¿Por qué usar Roots?

Las Roots cumplen varios propósitos importantes:

Guía: Informan a los servidores sobre los recursos y ubicaciones relevantes.

Claridad: Las Roots dejan claro qué recursos son parte de tu espacio de trabajo.

Organización: Múltiples Roots te permiten trabajar con diferentes recursos simultáneamente.

Cómo funcionan las Roots

Cuando un cliente soporta Roots, este:

Declara la capacidad roots durante la conexión.

Proporciona una lista de Roots sugeridas al servidor.

Notifica al servidor cuando las Roots cambian (si es soportado).

Aunque las Roots son informativas y no estrictamente obligatorias, los servidores deberían:

Respetar las Roots proporcionadas.

Usar las URIs de las Roots para localizar y acceder a los recursos.

Priorizar las operaciones dentro de los límites de las Roots.

Casos de uso comunes

Las Roots se utilizan comúnmente para definir:

Directorios de proyectos

Ubicaciones de repositorios

Endpoints de API

Ubicaciones de configuración

Límites de recursos

Mejores prácticas

Cuando se trabaja con Roots:

Solo sugiere los recursos necesarios.

Usa nombres claros y descriptivos para las Roots.

Supervisa la accesibilidad de las Roots.

Maneja los cambios de Roots con elegancia.

Ejemplo

Aquí se muestra cómo un cliente típico de MCP podría exponer las Roots:

{
  "roots": [
    {
      "uri": "file:///home/user/projects/frontend",
      "name": "Frontend Repository"
    },
    {
      "uri": "https://api.example.com/v1",
      "name": "API Endpoint"
    }
  ]
}

Esta configuración sugiere que el servidor se centre tanto en un repositorio local como en un endpoint de API, manteniéndolos lógicamente separados.

¿Qué son las Roots?#

¿Por qué usar Roots?#

Cómo funcionan las Roots#

Casos de uso comunes#