Installation

Read.Wiki is an Astro + Starlight documentation template with a real MCP server bundled in. This section walks you from zero to a running dev server.

System requirements

• Node.js: ≥ 20. Astro 6 dropped 18 support.
• Package manager: the repo uses pnpm (pnpm-lock.yaml is checked in). npm or yarn will work but won’t respect the lockfile.
• OS: Windows / macOS / Linux.
• Optional: a server with a Node runtime if you want /mcp in production. Pure static hosts can only serve llms.txt and llms-full.txt.

Clone the repository

git clone https://github.com/aklmans/read-wiki-by-cc-opus.git
cd read-wiki-by-cc-opus

Install dependencies

pnpm install

If pnpm isn’t on your machine:

npm install -g pnpm
# or via corepack
corepack enable && corepack prepare pnpm@latest --activate

Start the dev server

pnpm dev

Wait for Local: http://localhost:4321/ and open /zh/ or /en/ in a browser.

Probe the MCP endpoint

The dev server exposes /mcp alongside the HTML pages:

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

You should see the search_docs tool descriptor. A 405 means you sent GET; the endpoint is POST-only.

Next

• Configuration — version, locales, custom components
• First example — add your own page
• Core concepts — understand the three access paths