一份教程 + 思路演示（兼具 Demo），展示如何为 VitePress 文档站点赋予 AI 语义搜索能力

📖 在线文档：vector-mcp-edge.mintimate.cn

本项目是一份教程文档与思路演示（兼具可运行的 Demo），围绕「如何为 VitePress 文档添加 MCP 智能检索」这一主题，提供从零到一的完整搭建思路与实践参考。

核心思路：通过 CNB 平台的知识库能力实现文档向量化，结合腾讯云 EdgeOne Pages 的 Go Cloud Function 在边缘部署 MCP Server + 网页端 AI 助手，让 AI 工具能够语义化检索你的文档内容。

注意：本项目的重点在于讲解思路和演示流程，而非提供一个开箱即用的工具库。你可以参考本项目的方案设计和代码示例，将相同的思路应用到自己的文档站点中。

• 🧠 文档向量化 — 如何利用 CNB 知识库，一行配置实现文档自动分块、Embedding、索引构建
• ⚡ Go Cloud Function 边缘部署 — 如何在 EdgeOne Pages 的 Go 边缘函数中实现 MCP Server + RAG 问答 + Tool Use，零服务器成本、全球加速
• 🌐 MCP 协议接入 — 如何通过标准化 Model Context Protocol 接口，对接 Cursor、VS Code、Claude Desktop 等主流 AI 工具
• 🤖 网页端 AI 助手 — 如何为文档站点内嵌 AI 问答助手，让用户直接在网页上提问
• 🔀 方案演进对比 — 从早期 JS MCP + Go RAG 双方案到 Go Cloud Function 统一方案的演进历程
• 🛠️ 落地实践经验 — 最佳实践、FAQ、故障排查、术语表，覆盖从搭建到维护的常见问题

本项目自身就是 Go Cloud Function 方案的真实落地产物，已部署可用的 MCP 端点：

项目	说明
服务地址	https://vector-mcp-edge.mintimate.cn/mcp
传输协议	Streamable HTTP
协议版本	2025-03-26

复制以下配置到你的 AI 工具中，即可立即体验：

Cursor (.cursor/mcp.json)：

{
  "mcpServers": {
    "vector-mcp-edge-docs": {
      "url": "https://vector-mcp-edge.mintimate.cn/mcp",
      "transport": "streamable-http"
    }
  }
}

VS Code (.vscode/mcp.json)：

{
  "servers": {
    "vector-mcp-edge-docs": {
      "type": "http",
      "url": "https://vector-mcp-edge.mintimate.cn/mcp"
    }
  }
}

更多客户端配置请参阅 在线文档 - MCP 端点。

技术	用途
VitePress	静态文档站点生成
CNB	代码托管 & 知识库向量化
EdgeOne Pages	站点托管 & Go Cloud Function 边缘部署
Go Cloud Function	MCP Server + RAG 问答 + Tool Use
Slidev	演示文稿
Mermaid	架构图 & 流程图渲染

• Node.js >= 22
• npm
• Go >= 1.24（用于本地开发 Cloud Function）

# 克隆仓库
git clone https://cnb.cool/shenzhen/lecturer/vector-mcp-edge.git
cd vector-mcp-edge

# 安装依赖（会自动安装 slides 子项目依赖）
npm install

# 启动文档站点开发服务器
npm run dev

# 构建文档站点（含演示文稿）
npm run build

构建产物输出到 .vitepress/dist 目录。

npm run preview

vector-mcp-edge/
├── .cnb.yml                  # CNB 平台 CI/CD 配置（向量化 + 同步 + 部署）
├── .vitepress/
│   ├── config.mts            # VitePress 站点配置
│   └── theme/                # 自定义主题与样式
├── cloud-functions/          # Go Cloud Function 源码（MCP + RAG + Tool Use）
│   ├── index.go              # 入口文件
│   ├── go.mod                # Go 模块定义
│   └── internal/             # 内部实现
│       ├── config/           # 配置管理
│       ├── handler/          # 请求处理（MCP、RAG、Tool Use）
│       └── knowledge/        # CNB 知识库 API 封装
├── guide/                    # 搭建教程文档
│   ├── getting-started.md    # 快速开始
│   ├── deploy-cnb.md         # 托管到 CNB
│   ├── knowledge-base.md     # 知识库向量化
│   ├── cloud-function.md     # Go Cloud Function 搭建（推荐）
│   ├── deploy-verify.md      # 部署与验证
│   ├── ai-assistant.md       # 配置网页端 AI 助手
│   ├── extend-tools.md       # 扩展更多 MCP 工具
│   ├── mcp-server.md         # JS Edge Function（已归档）
│   └── ...                   # 最佳实践、FAQ、故障排查、术语表
├── features/                 # 功能与效果文档
│   ├── solutions.md          # 方案演进与对比
│   ├── architecture.md       # 架构全景图
│   ├── solution-go-function.md  # Go Cloud Function 方案详情
│   ├── mcp-endpoint.md       # 本站 MCP 端点（Live Demo）
│   ├── slides.md             # 演示文稿入口
│   ├── solution-mcp.md       # JS Serverless MCP（已归档）
│   └── solution-rag.md       # Go RAG 自建服务（已归档）
├── slides/                   # Slidev 演示文稿
│   ├── slides.md             # 演示文稿内容
│   └── package.json          # Slidev 依赖
├── public/                   # 静态资源
├── edgeone.json              # EdgeOne Pages 部署配置
├── index.md                  # 站点首页
├── package.json              # 项目依赖配置
└── LICENSE                   # MIT 开源协议

项目已配置 .cnb.yml，推送到 CNB 平台后会自动触发：

1. 知识库向量化 — 自动扫描所有 Markdown 文件，构建向量索引
2. 代码同步 — 自动同步到 GitHub 镜像仓库
3. 站点部署 — 构建 VitePress 产物 + Slidev 演示文稿，部署到 EdgeOne Pages（含 Go Cloud Function）

npm run build
# 使用 EdgeOne CLI 部署 .vitepress/dist 目录

完整文档请访问 👉 vector-mcp-edge.mintimate.cn

• 上手体验 — 方案对比、架构设计、在线 Demo
• 搭建教程 — 从零开始，一步步搭建 MCP 智能检索
• MCP 端点 — 复制配置即可在 AI 编辑器中体验
• 演示文稿 — 项目介绍 Slides

• 想为自己的文档站点添加 AI 语义搜索能力的开发者
• 对 MCP 协议、向量检索、边缘函数感兴趣的技术爱好者
• 希望了解 CNB + EdgeOne 生态实践的同学

本项目基于 MIT 协议开源。