Comment installer Zread ?

Copiez sur cette page la configuration stdio pour Cursor, Claude Desktop, Claude Code ou VS Code. Elle utilise l'installation de l'éditeur, pas un proxy PlugMCP.

Zread nécessite-t-il une clé API ?

Aucune variable d'environnement requise n'est indiquée sur cette fiche.

Quel transport Zread utilise-t-il ?

Zread s'exécute en local via stdio.

# Run with uvx
uvx zread

# Or with pipx
pipx run zread

# stdio mode
uvx zread mcp

# HTTP mode
uvx zread mcp http

export ZREAD_TOKEN=your-token

# Interactive multi-turn chat
zread ai openclaw/openclaw

# Single question
zread ai facebook/react "How is this project structured?"

# Start the MCP server
zread mcp [stdio|http|sse] [address] [options]

# Show the documentation outline
zread ls <repo> [-l zh|en] [-j] [-p]

# Read a documentation page or a source file
zread cat <repo> [slug_or_path] [-l zh|en] [-j] [-p]
#
# Automatic argument detection:
# - If the first argument is only repo and the second is a slug/index (for example 1-overview, 1), it reads a zread doc page
# - Other forms (for example README.md, owner/repo/README.md#L1-10, github.com/owner/repo/README.md#L1-10) read a GitHub file

# Search
zread find <query>                        # Search GitHub repositories
zread find <repo> <query>                 # Search within a repository's docs

# Discover recommended repositories
zread rand [topic] [-l zh|en] [-j] [-p]

# Show trending repositories
zread top [weeks] [-l zh|en] [-j] [-p]

# Show repository status and metadata (silently submits unindexed repos and refreshes stale docs)
zread stat <repo> [-l zh|en] [-j] [-p]

# Ask the repository AI (requires a free account token)
zread ai <repo> [question] [-l zh|en] [-t token] [-p] [-j] [-m model]

# Export repository docs locally and generate llms.txt / llms-full.txt
zread cp <repo> [output_dir] [-l zh|en] [-c concurrency]

Option	Description
`-l, --lang {zh,en}`	Language priority: `--lang` > `ZREAD_LANG` > system locale, default `en`.
`-j, --json`	Output as JSON
`-p, --plain`	Output plain text
`-t, --token`	ZREAD_TOKEN
`-h, --help`	Show help
`-v, --version`	Show version

# MCP server
uvx zread mcp                          # stdio mode (default)
uvx zread mcp http                     # HTTP mode
uvx zread mcp http :8080               # Custom port
uvx zread mcp http 0.0.0.0:3000/custom # Custom address and path

# Docs
uvx zread ls golang/go
uvx zread cat vuejs/vue
uvx zread cat vuejs/vue 1
uvx zread cat vuejs/vue 1-overview
uvx zread cat golang/go README.md
uvx zread cat python/cpython Lib/http/client.py
uvx zread cat github.com/facebook/react/README.md#L1-10
uvx zread cat facebook/react/README.md#L1-10
uvx zread cat facebook/react README.md 5 10
uvx zread cat facebook/react README.md 5-10
uvx zread cat facebook/react README.md 5~
uvx zread cat facebook/react/README.md 5:
uvx zread find facebook/react hooks

# Discovery
uvx zread top
uvx zread top 4
uvx zread rand python
uvx zread rand awesome-list

# Repository info
uvx zread stat torvalds/linux

# AI Q&A
uvx zread ai golang/go "How do I choose between channels and mutexes?" -t your-token
uvx zread ai python/cpython --model claude-sonnet-4.6 -t your-token
uvx zread ai rust-lang/rust

# Export docs
uvx zread cp golang/go
uvx zread cp python/cpython -l zh
uvx zread cp vuejs/vue -c 20

{
  "mcpServers": {
    "zread": {
      "command": "uvx",
      "args": ["--env", "ZREAD_TOKEN=your-token", "zread", "mcp"]
    }
  }
}

Tool	Description
`read_doc`	Get the content of a specific documentation page
`search_wiki`	Search keywords in repository documentation
`get_doc_outline`	Get the repository documentation outline
`discover_repo`	Discover a recommended repository at random
`get_trending`	Get trending repository rankings
`get_repo_info`	Get repository information and indexing status
`read_source_file`	Read source code file contents
`ask_ai`	Ask the repository AI a question (token required), supports `glm-5.1` and `claude-sonnet-4.6`

Visit https://zread.ai and sign in
Press F12 to open the browser console

Run:

prompt(
  "copy token",
  JSON.parse(localStorage.getItem("CGX_AUTH_STORAGE")).state.token,
);

Copy the token from the popup dialog

Variable	Description
`ZREAD_TOKEN`	Free JWT token from your zread.ai account, only required for AI Q&A
`ZREAD_LANG`	Default language (`zh` / `en`), lower priority than `--lang` and higher than system locale
`ZREAD_MODEL`	Default AI model (`glm-5.1` / `claude-sonnet-4.6`), lower priority than `--model`

[zread]
token = "your-token-here"
lang = "zh"  # optional, defaults to "zh"
model = "glm-5.1"  # optional, defaults to "glm-5.1", also supports "claude-sonnet-4.6"