跳转到内容
Read.Wiki

安装

Read.Wiki 是一个 Astro + Starlight 文档站模板，附带真实的 MCP 服务端。本节带你从零跑起来。

系统要求

Section titled “系统要求”
  • Node.js：≥ 20。Astro 6 不再支持 18。
  • 包管理器：仓库使用 pnpm（带 pnpm-lock.yaml）。如果只用 npm/yarn，可以照样跑，但锁文件不会被尊重。
  • 操作系统：Windows / macOS / Linux 任意。
  • 可选：自有服务器 + Node 运行时，用于部署 /mcp。纯静态托管只能提供 llms.txt / llms-full.txt。

克隆仓库

Section titled “克隆仓库”
Terminal window
git clone https://github.com/aklmans/read-wiki-by-cc-opus.git
cd read-wiki-by-cc-opus

安装依赖

Section titled “安装依赖”
Terminal window
pnpm install

如果系统没有 pnpm：

Terminal window
npm install -g pnpm
# 或者通过 corepack
corepack enable && corepack prepare pnpm@latest --activate

启动开发服务器

Section titled “启动开发服务器”
Terminal window
pnpm dev

看到 Local: http://localhost:4321/ 就成功了。打开浏览器访问 /zh/ 或 /en/。

验证 MCP 端点

Section titled “验证 MCP 端点”

dev server 也会同时提供 /mcp：

Terminal window
curl -X POST http://localhost:4321/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

应当返回 search_docs 工具的描述。如果返回 405，确认请求方法是 POST 而不是 GET。

下一步

Section titled “下一步”