Sitemap MCP Server

网站地图MCP服务器

通过从任何URL获取、解析和可视化站点地图，发现网站架构并分析网站结构。无需手动探索，即可发现隐藏的页面并提取有组织的层次结构。

包括Claude Desktop的即用型提示模板，可让您分析网站、检查站点地图健康状况、提取URL、查找缺失内容，并仅使用URL输入创建可视化。

演示

获取有关利用站点地图功能的任何网站的问题的答案。

Cursor: how many pages does a modelcontextprotocol.io have?

Claude + prompt: visualize the sitemap in a diagram of windsurf.com

点击工具按钮旁边的“附加”按钮：

然后选择 visualize_sitemap:

现在我们进入windsurf.com：

我们得到了站点地图的可视化：

安装

确保 紫外线 已安装。

在Claude Desktop、Cursor或Windsurf中安装

将此条目添加到您的 claude_desktop_config json光标设置等：

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

如果克劳德正在运行，请重新启动它。对于光标，只需按刷新和/或在设置中启用MCP服务器。

通过Smithery安装

通过以下方式自动安装Claude Desktop的站点地图 史密瑟里:

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

MCP检查员

uv + stdio transport

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

打开MCP检查器http://127.0.0.1:6274，选择 stdio 并连接到MCP服务器。

uv + sse transport

# 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

打开MCP检查器http://127.0.0.1:6274，选择 sse 并连接到MCP服务器。

苏格兰和南方能源公司运输

如果要使用SSE传输，请执行以下步骤：

1. 启动服务器：

uvx sitemap-mcp-server

1. 配置您的MCP客户端，例如Cursor：

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

地方发展

有关从源代码构建和运行项目的说明，请参阅 开发商.md 导游。

用法

工具

以下工具可通过MCP服务器获得：

• get_sitemap_tree -从网站URL获取并解析站点地图树

- 论据： url （网站URL）， include_pages （可选，布尔值） - 返回：站点地图树结构的JSON表示

• get_sitemap_pages -使用过滤选项从网站的站点地图中获取所有页面

- 论据： url （网站URL）， limit （可选）， include_metadata （可选）， route （可选）， sitemap_url （可选）， cursor （可选） - 返回：带有分页元数据的JSON页面列表

• get_sitemap_stats -获取网站站点地图的统计信息

- 论据： url （网站URL） - 返回：带有站点地图统计信息的JSON对象，包括页面计数、修改日期和子站点地图详细信息

• parse_sitemap_content -直接从XML或文本内容解析站点地图

- 论据： content （站点地图XML内容）， include_pages （可选，布尔值） - 返回：解析后的站点地图的JSON表示

提示

服务器包括现成的提示，这些提示在Claude Desktop中显示为模板。安装服务器后，您将在“模板”菜单中看到这些模板（单击消息输入旁边的+图标）：

• 分析网站地图：提供网站站点地图的全面结构分析
• 检查网站地图运行状况：评估站点地图的SEO和健康指标
• 从网站地图中提取URL：从站点地图中提取和过滤特定URL
• 在网站地图中查找缺失的内容：识别网站站点地图中的内容空白
• 可视化网站地图结构：创建站点地图结构的Mermaid.js图表可视化

要使用这些提示，请执行以下操作：

1. 单击Claude Desktop中消息输入旁边的+图标
2. 从列表中选择所需的模板
3. 在提示时填写网站URL
4. Claude将执行适当的站点地图分析

例子

获取完整的网站地图

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

获取具有过滤和分页功能的页面

按路线筛选

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

按特定子项筛选

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

基于光标的分页

服务器实现了基于MCP光标的分页，以有效地处理大型站点地图：

初始请求：

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

分页响应：

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

使用游标的后续请求：

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

当没有更多结果时 nextCursor 字段将不在响应中。

获取网站地图统计信息

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

回复包括每个子地图的总统计数据和详细统计数据：

{
  "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
    }
  ]
}

这使MCP客户能够了解哪些子地图可能值得进一步调查。然后，您可以使用 sitemap_url 参数在 get_sitemap_pages 从特定子地图中过滤页面。

直接解析网站地图内容

{
  "name": "parse_sitemap_content",
  "arguments": {
    "content": "https://example.com/",
    "include_pages": true
  }
}

致谢

• 此MCP服务器利用 终极站点地图解析器 图书馆
• 使用 模型上下文协议 开发包

许可证

该项目根据MIT许可证获得许可。请参阅 许可证 文件以获取详细信息。