网站 MCP 服务器

为这个 Hugo 网站量身定制的轻量级 MCP 服务器。它提供站点感知工具，帮助 MCP 客户端（如 Claude Desktop、OpenAI Desktop）探索内容并触发常见项目任务。

Slug 语义化优化

本 MCP 服务器支持自动生成语义化英文 slug，结合内容标题和描述，智能分词、术语优先级排序，自动转换为 SEO 友好的英文路径。

主要特性：

• 支持中英文内容自动生成英文 slug
• 结合丰富技术/行业/产品词典，智能分词
• 按语义优先级组合 slug，避免重复和泛化
• 适用于博客、文档、书籍等所有内容类型

示例：

标题	描述	生成 slug
日本光冈汽车介绍	日本光冈汽车品牌历史、设计特色与代表车型介绍	japan-automotive-mitsuoka-motor-design-models
数字信息获取对比	数字时代信息获取方式对比与大脑能量消耗分析	digital-information-acquisition
Kubernetes 服务网格 Istio 最佳实践	云原生架构下的微服务治理与可观测性最佳实践	kubernetes-service-mesh-istio-best-practices

用法：

可通过 suggest_slug、plan_new_content、create_content 工具自动生成 slug，无需手动指定。

工具

• list_content：列出带有元数据（标题/语言/类型/URL）的 Markdown 页面。

• get_page：按路径读取 Markdown 文件。

• search_content：全仓库内容搜索（简单文本匹配）并显示片段。

• page_url：计算内容文件的站点 URL。

• open_in_editor_link：返回 http://localhost:8089/open?file=... 用于快速编辑（需要 make server）。

• run_task：运行已记录的 npm 脚本（generate-analysis、upload-images、check-image-dimensions）。

• suggest_slug：智能生成英文 slug，支持中英文输入。

本地运行

npm run mcp:website

它在 stdio 上运行，因此您通常通过 MCP 客户端而不是手动使用它。

Slug 语义化 API 用法

可通过 MCP 客户端或 API 直接调用 slug 相关工具：

{
  "tool": "suggest_slug",
  "args": {
    "title": "Kubernetes 服务网格 Istio 最佳实践",
    "description": "云原生架构下的微服务治理与可观测性最佳实践",
    "lang": "zh"
  }
}

返回：

{
  "slug": "kubernetes-service-mesh-istio-best-practices"
}

在客户端中配置

Claude Desktop（示例）

编辑您的 Claude 配置（例如 ~/Library/Application Support/Claude/claude_desktop_config.json）并添加：

{
  "servers": {
    "website": {
      "command": "npx",
      "args": ["-y", "tsx", "tools/mcp/website-mcp-server.ts"],
      "env": {
        "WEBSITE_ROOT": "/Users/jimmy/Workspace/github/rootsongjc/website"
      }
    },
    "website-filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/jimmy/Workspace/github/rootsongjc/website"
      ]
    }
  },
  "inputs": []
}

• 为您的机器调整绝对路径。
• 根据需要可选择包含其他标准服务器（filesystem/web/shell）。

注意事项

• 需要 Node.js 20+ 和已安装的仓库依赖项（npm i）。
• 使用 stdio 传输；服务器本身不暴露网络。
• open_in_editor_link 假设来自 make server 的本地文件服务器在端口 8089 上。
• search_content 是简单的文本搜索。对于语义/RAG，在后续版本中与 tools/rag-worker/ 集成。
• slug 生成算法已支持丰富技术/行业/产品词典，自动分词和语义组合。

开发

• 服务器入口：tools/mcp/website-mcp-server.ts
• 脚本：npm run mcp:website
• 根据项目需求演变自定义工具或添加新工具。