站点地图-MCP服务器

Name: 站点地图-MCP服务器
Author: mugoosse

作者：mugoosse6 星标更新：2025-04-24

安装使用来源：spider==github.com

项目介绍

Sitemap MCP Server

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

包括用于Claude Desktop的现成提示模板，只需输入一个URL即可分析网站、检查站点地图健康状况、提取URL、查找缺失内容并创建可视化图表。

License PyPI

示例

回答关于任何网站的问题，利用站点地图的力量。

<details><summary>Cursor：modelcontextprotocol.io有多少个页面？</summary> <br/> <img width="1541" alt="image" src="https://gips2.baidu.com/it/u=2003477342,1700865096&fm=3081&app=3081&f=PNG?w=3082&h=776" /> </details> <details><summary>Claude + 提示：在windsurf.com的图表中可视化站点地图</summary> <br/>

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

然后选择visualize_sitemap：

现在我们输入windsurf.com：

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

安装

确保已安装uv。

在Claude Desktop、Cursor或Windsurf中安装

在你的claude_desktop_config.json，Cursor设置等中添加以下条目：

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

如果Claude正在运行，请重启它。对于Cursor，只需刷新并在设置中启用MCP服务器。

通过Smithery安装

要通过Smithery自动为Claude Desktop安装sitemap：

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

MCP Inspector

<details><summary>uv + stdio传输</summary>

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

在http://127.0.0.1:6274打开MCP Inspector，选择stdio传输，并连接到MCP服务器。

</details> <details><summary>uv + sse传输</summary>

# 启动服务器
uvx sitemap-mcp-server

# 在单独的终端启动MCP Inspector
npx @modelcontextprotocol/inspector connect http://127.0.0.1:8050

在http://127.0.0.1:6274打开MCP Inspector，选择sse传输，并连接到MCP服务器。

</details>

SSE传输

如果你想使用SSE传输，请按照以下步骤操作：

启动服务器：

uvx sitemap-mcp-server

配置你的MCP客户端，例如Cursor：

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

本地开发

有关从源代码构建和运行项目的说明，请参阅DEVELOPERS.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图表可视化

使用这些提示：

在Claude Desktop的消息输入旁边点击+图标
从列表中选择所需的模板
当提示时输入网站URL
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": [...],  // 第一批页面
  "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客户端了解哪些子站点地图可能需要进一步调查。然后可以使用get_sitemap_pages中的sitemap_url参数来筛选特定子站点地图中的页面。

直接解析站点地图内容

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

致谢

本MCP服务器利用了ultimate-sitemap-parser库
使用Model Context Protocol Python SDK构建

许可证

本项目根据MIT许可证发布。详见LICENSE文件。