Mapa del sitio del servidor MCP

El servidor MCP de mapas de sitio proporciona a los agentes de IA y clientes MCP potentes herramientas para obtener, analizar y visualizar mapas de sitio web. Admite todos los formatos estándar de mapas de sitio, como XML, Google News y mapas de texto sin formato.

Manifestación

Obtenga respuestas a preguntas sobre cualquier sitio web que aproveche el poder de los mapas del sitio.

Haga clic en el botón "adjuntar" junto al botón de herramientas:

Luego seleccione visualize_sitemap :

Ahora entramos en windsurf.com:

Y obtenemos una visualización del mapa del sitio:

Instalación

Asegúrese de que el uv esté instalado.

Instalación en Claude Desktop, Cursor o Windsurf

Agregue esta entrada a su claude_desktop_config.json , configuración del cursor, etc.:

{
  "mcpServers": {
    "sitemap": {
      "command": "uvx",
      "args": ["sitemap-mcp-server"],
      "env": { "TRANSPORT": "stdio" }
    }
  }
}

Reinicia Claude si se está ejecutando. Para el cursor, simplemente presiona "Actualizar" o activa el servidor MCP en la configuración.

Instalación mediante herrería

Para instalar el mapa del sitio para Claude Desktop automáticamente a través de Smithery :

npx -y @smithery/cli install @mugoosse/sitemap --client claude

Inspector de MCP

npx @modelcontextprotocol/inspector env TRANSPORT=stdio uvx sitemap-mcp-server

Abra el Inspector MCP en http://127.0.0.1:6274 , seleccione el transporte stdio y conéctese al servidor MCP.

# Start the server
uvx sitemap-mcp-server

# Start the MCP Inspector in a separate terminal
npx @modelcontextprotocol/inspector connect http://127.0.0.1:8050

Abra el Inspector MCP en http://127.0.0.1:6274 , seleccione el transporte sse y conéctese al servidor MCP.

Transporte SSE

Si desea utilizar el transporte SSE, siga estos pasos:

Iniciar el servidor:

uvx sitemap-mcp-server

Configure su cliente MCP, por ejemplo Cursor:

{
  "mcpServers": {
    "sitemap": {
      "transport": "sse",
      "url": "http://localhost:8050/sse"
    }
  }
}

Desarrollo local

Para obtener instrucciones sobre cómo crear y ejecutar el proyecto desde la fuente, consulte la guía DEVELOPERS.md .

Uso

Herramientas

Las siguientes herramientas están disponibles a través del servidor MCP:

get_sitemap_tree : obtiene y analiza el árbol del mapa del sitio desde la URL de un sitio web
- Argumentos: url (URL del sitio web), include_pages (opcional, booleano)
- Devuelve: representación JSON de la estructura de árbol del mapa del sitio
get_sitemap_pages : obtiene todas las páginas del mapa del sitio de un sitio web con opciones de filtrado
- Argumentos: url (URL del sitio web), limit (opcional), include_metadata (opcional), route (opcional), sitemap_url (opcional), cursor (opcional)
- Devuelve: lista JSON de páginas con metadatos de paginación
get_sitemap_stats - Obtener estadísticas sobre el mapa del sitio de un sitio web
- Argumentos: url (URL del sitio web)
- Devoluciones: objeto JSON con estadísticas del mapa del sitio, incluidos recuentos de páginas, fechas de modificación y detalles del submapa del sitio
parse_sitemap_content - Analiza un mapa del sitio directamente desde su contenido XML o de texto
- Argumentos: content (contenido XML del mapa del sitio), include_pages (opcional, booleano)
- Devuelve: representación JSON del mapa del sitio analizado

Indicaciones

El servidor incluye indicaciones listas para usar que aparecen como plantillas en Claude Desktop. Después de instalar el servidor, verá estas plantillas en el menú "Plantillas" (haga clic en el icono + junto a la entrada del mensaje):

Analizar el mapa del sitio : proporciona un análisis integral de la estructura del mapa del sitio de un sitio web.
Comprobar el estado del mapa del sitio : evalúa el SEO y las métricas de salud de un mapa del sitio
Extraer URL del mapa del sitio : extrae y filtra URL específicas de un mapa del sitio
Encontrar contenido faltante en el mapa del sitio : identifica lagunas de contenido en el mapa del sitio de un sitio web
Visualizar la estructura del mapa del sitio : crea un diagrama de Mermaid.js que visualiza la estructura del mapa del sitio

Para utilizar estas indicaciones:

Haga clic en el ícono + junto a la entrada del mensaje en Claude Desktop
Seleccione la plantilla deseada de la lista
Complete la URL del sitio web cuando se le solicite
Claude ejecutará el análisis apropiado del mapa del sitio.

Ejemplos

Obtenga un mapa del sitio completo

{
  "name": "get_sitemap_tree",
  "arguments": {
    "url": "https://example.com",
    "include_pages": true
  }
}

Obtener páginas con filtrado y paginación

Filtrar por ruta

{
  "name": "get_sitemap_pages",
  "arguments": {
    "url": "https://example.com",
    "limit": 100,
    "include_metadata": true,
    "route": "/blog/"
  }
}

Filtrar por submapa del sitio específico

{
  "name": "get_sitemap_pages",
  "arguments": {
    "url": "https://example.com",
    "limit": 100,
    "include_metadata": true,
    "sitemap_url": "https://example.com/blog-sitemap.xml"
  }
}

Paginación basada en cursor

El servidor implementa la paginación basada en cursor MCP para gestionar mapas de sitios grandes de manera eficiente:

Solicitud inicial:

{
  "name": "get_sitemap_pages",
  "arguments": {
    "url": "https://example.com",
    "limit": 50
  }
}

Respuesta con paginación:

{
  "base_url": "https://example.com",
  "pages": [...],  // First batch of pages
  "limit": 50,
  "nextCursor": "eyJwYWdlIjoxfQ=="
}

Solicitud posterior con cursor:

{
  "name": "get_sitemap_pages",
  "arguments": {
    "url": "https://example.com",
    "limit": 50,
    "cursor": "eyJwYWdlIjoxfQ=="
  }
}

Cuando no haya más resultados, el campo nextCursor estará ausente de la respuesta.

Obtener estadísticas del mapa del sitio

{
  "name": "get_sitemap_stats",
  "arguments": {
    "url": "https://example.com"
  }
}

La respuesta incluye estadísticas totales y estadísticas detalladas de cada submapa del sitio:

{
  "total": {
    "url": "https://example.com",
    "page_count": 150,
    "sitemap_count": 3,
    "sitemap_types": ["WebsiteSitemap", "NewsSitemap"],
    "priority_stats": {
      "min": 0.1,
      "max": 1.0,
      "avg": 0.65
    },
    "last_modified_count": 120
  },
  "subsitemaps": [
    {
      "url": "https://example.com/sitemap.xml",
      "type": "WebsiteSitemap",
      "page_count": 100,
      "priority_stats": {
        "min": 0.3,
        "max": 1.0,
        "avg": 0.7
      },
      "last_modified_count": 80
    },
    {
      "url": "https://example.com/blog/sitemap.xml",
      "type": "WebsiteSitemap",
      "page_count": 50,
      "priority_stats": {
        "min": 0.1,
        "max": 0.9,
        "avg": 0.5
      },
      "last_modified_count": 40
    }
  ]
}

Esto permite a los clientes de MCP comprender qué submapas de sitio podrían ser de interés para una investigación más exhaustiva. Posteriormente, puede usar el parámetro sitemap_url en get_sitemap_pages para filtrar las páginas de un submapa de sitio específico.

Analizar el contenido del mapa del sitio directamente

{
  "name": "parse_sitemap_content",
  "arguments": {
    "content": "<?xml version=\"1.0\" encoding=\"UTF-8\"?><urlset xmlns=\"http://www.sitemaps.org/schemas/sitemap/0.9\"><url><loc>https://example.com/</loc></url></urlset>",
    "include_pages": true
  }
}

Expresiones de gratitud

Este servidor MCP aprovecha la biblioteca de análisis de mapas de sitios definitiva
Construido con el SDK de Python del Protocolo de Contexto de Modelo

Licencia

Este proyecto está licenciado bajo la Licencia MIT. Consulte el archivo de LICENCIA para más detalles.

Sitemap MCP Server

Integrations