What can you do with this server?

This server provides fast, local semantic search over Claude Code documentation via MCP tools. * search_docs: Query the official Claude Code docs and get ranked snippets with metadata (chunk ID, category, source file). Supports filtering by category, custom result limits, and aliases. * reload_docs: Force a refresh of the documentation and rebuild the search index. * get_status: Check server health, trust mode, docs source, index age, load errors, and active warnings. * dump_index_metadata: Inspect indexing details such as categories, chunk counts, headings, code literals, config keys, and distinctive terms. * Supports caching, stale-fallback, and configurable trust modes for reliable local search.

How do I use claude-code-docs?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@claude-code-docs search for Claude Code plugin setup" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

claude-code-docs

by jpsweeney97

Overview Schema Source Related Servers Discussions Admin

TypeScript

Local

claude-code-docs MCP Server

Version: 1.0.0
Runtime: Node.js >=18 (TypeScript, ESM)
Key dependencies: @modelcontextprotocol/sdk, zod, yaml, stemmer
License: Not specified in this package

Problem Statement

Claude Code's documentation is large and frequently updated, but most MCP clients need fast, local search results rather than full-document scans. This server fetches the official docs, chunks them into semantic sections, builds an in-memory BM25 index, and exposes MCP tools that return ranked snippets.

The result is a small, focused MCP server that provides deterministic, query-focused results with minimal client integration surface: a stdio transport, four tools, and a cache-backed indexing pipeline.

Related MCP server: MCP Context Manager

Quick Start

From this directory, install dependencies: npm install
Build the server: npm run build
Start the MCP server (stdio transport): npm start

To use the server from an MCP client, see Client Configuration below.

How It Works

Pipeline overview:

Fetch official docs from the configured URL and parse Source: markers into sections.
Synthesize frontmatter (topic/id/category) and chunk each section at semantic boundaries.
Tokenize and build a BM25 index (with heading-based score boosting).
Serve MCP tool calls against the in-memory index.

Design properties:

Two-cache model: a raw content cache (TTL-based) and a serialized index cache (version-gated).
Fail-open on expected fetch/validation errors by falling back to stale cache when allowed.
Fail-closed on programmer errors to avoid masking regressions.
Concurrency-safe index loading with a shared in-flight promise and retry backoff.

Configuration

Environment variables:

Variable	Default	Purpose	Constraints / Behavior
`DOCS_URL`	`https://code.claude.com/docs/llms-full.txt`	Source documentation URL.	Validated on startup; must be a valid `https` URL.
`DOCS_TRUST_MODE`	`official`	Trust mode controlling source validation and canary policy.	`official`: pins source to `code.claude.com`, full canary evaluation (fallback-segment delta + relative-drift checks + absolute fallback-ratio warn). `unsafe`: accepts any HTTPS URL, structural canaries only (count + size checks). Use `unsafe` only for local testing or private mirrors.
`RETRY_INTERVAL_MS`	`60000`	Retry backoff for failed index loads.	Validated on startup; must be an integer between `1000` and `600000`.
`CACHE_TTL_MS`	`86400000`	Content cache freshness window in milliseconds.	Integer >=0. `0` means the cache is never considered fresh (fetch each load); values > 1 year are capped.
`DOCS_CACHE_MAX_STALE_MS`	`0`	Maximum allowed age for stale cache fallback.	Validated on startup; must be an integer >=0. `0` disables the limit.
`MIN_SECTION_COUNT`	(unset)	Override for the canary's index floor.	Integer >=0. Unset → canary uses its trust-mode default (official: 40, unsafe: 3). `0` disables the index floor. Does NOT affect the content-cache write guard, which is fixed at 40 (`CACHE_WRITE_MIN_SECTIONS`) and is NOT env-disableable.
`MAX_INDEX_CACHE_BYTES`	`52428800`	Max serialized index size in bytes before writing cache.	Validated on startup; must be an integer >0. If exceeded, index cache write is skipped (server keeps in-memory index).
`MAX_RESPONSE_BYTES`	`10485760`	Max HTTP response size in bytes.	Integer >0. If declared or streamed size exceeds, fetch fails and falls back to stale cache when available.
`FETCH_TIMEOUT_MS`	`30000`	HTTP fetch timeout in milliseconds.	Integer >=0. `0` results in immediate timeout.
`CACHE_PATH`	unset	Override the content cache file path.	Must include a filename (not just a directory). Does not move the index cache.
`XDG_CACHE_HOME`	unset	Base cache directory for defaults.	When set, affects default content and index cache paths.

Default cache locations:

macOS content cache: ~/Library/Caches/claude-code-docs/llms-full.txt
macOS index cache: ~/Library/Caches/claude-code-docs/llms-full.index.json
Linux content cache: $XDG_CACHE_HOME/claude-code-docs/llms-full.txt (or ~/.cache/claude-code-docs/llms-full.txt)
Linux index cache: same directory, llms-full.index.json

Notes:

CACHE_PATH overrides only the content cache file path. The index cache always uses the default cache directory derived from XDG_CACHE_HOME or OS defaults.
Content cache writes use a lock file (.lock) to coordinate concurrent writers.

Tools

`search_docs`

Searches the indexed Claude Code docs.

Parameters:

Name	Type	Required	Default	Notes
`query`	string	yes	-	Max 500 chars, trimmed, must be non-empty.
`limit`	integer	no	`5`	1-20.
`category`	string	no	-	Canonical categories or aliases (see below).

Canonical categories: hooks, skills, commands, agents, plugins, plugin-marketplaces, mcp, channels, settings, memory, overview, getting-started, cli, best-practices, interactive, security, providers, gateways, environments, ide, ci-cd, automation, agent-sdk, desktop, integrations, config, operations, troubleshooting, changelog, uncategorized

Aliases: subagents -> agents, sub-agents -> agents, slash-commands -> commands, claude-md -> memory, configuration -> config, gateway -> gateways

Return shape:

Field	Type	Description
`results[]`	object	Array of matches.
`results[].chunk_id`	string	Chunk identifier.
`results[].content`	string	Full chunk content.
`results[].snippet`	string	Snippet best matching the query.
`results[].category`	string	Derived category.
`results[].source_file`	string	Source URL/path.
`meta`	object	Index provenance attached to each search response.
`meta.trust_mode`	string	Active trust mode: `official` or `unsafe`.
`meta.source_kind`	string or null	How content was obtained: `fetched`, `cached`, `stale-fallback`, or `bundled-snapshot`. Null if no corpus loaded.
`meta.index_created_at`	string or null	ISO timestamp when the BM25 index was built. Null if not yet loaded.
`meta.corpus_age_ms`	integer or null	Milliseconds since the corpus content was obtained (`Date.now() - corpus.obtainedAt`). Null if no corpus loaded.
`error`	string	Present only on failure.

`reload_docs`

Forces a refresh of the docs and rebuilds the index.

Parameters: none.

Return:

Text message indicating success, chunk count, and any parse warnings.

`get_status`

Returns a lightweight runtime status snapshot. Use this to check index health, trust configuration, and canary evaluation results without triggering a reload or dumping the full metadata.

Parameters: none.

Return shape:

Field	Type	Description
`trust_mode`	string	Active trust mode: `official` or `unsafe`.
`docs_origin`	string	Hostname of the documentation source URL.
`docs_url`	string	Full documentation source URL.
`source_kind`	string or null	How content was obtained: `fetched`, `cached`, `stale-fallback`, or `bundled-snapshot`. Null if no corpus loaded.
`index_created_at`	string or null	ISO timestamp when the BM25 index was built. Null if not yet loaded.
`corpus_age_ms`	number or null	Milliseconds since corpus content was obtained. Null if no corpus loaded.
`corpus_obtained_at`	string or null	ISO timestamp when corpus content was obtained. Null if no corpus loaded.
`last_load_attempt_at`	string or null	ISO timestamp of the most recent load attempt. Null if never attempted.
`last_load_error`	string or null	Error message from the most recent failed load. Null if last load succeeded.
`warning_codes`	string[]	Active warning codes: `fallback_segment_drift`, `fallback_ratio_high`, `parse_issues`, `section_count_drift`, `stale_corpus`.
`is_loading`	boolean	Whether a load/reload is currently in progress.

`dump_index_metadata`

Returns structured index metadata useful for debugging ingestion, category mapping, and chunk coverage without dumping the full corpus.

Parameters: none.

Return shape:

Field	Type	Description
`index_version`	string	Serialized index format version.
`built_at`	string	ISO timestamp for the response build time.
`docs_epoch`	string or null	Content hash for the currently loaded docs.
`categories[]`	object	Per-category chunk metadata.
`categories[].name`	string	Canonical category name.
`categories[].aliases`	string[]	Accepted aliases for the category.
`categories[].chunk_count`	integer	Number of chunks in the category.
`categories[].chunks[]`	object	Chunk-level metadata for debugging and inventory building.

Resources

None.

Transport

The server uses stdio transport via the MCP SDK.

Client Configuration

Example .mcp.json entry:

{
  "mcpServers": {
    "claude-code-docs": {
      "command": "node",
      "args": ["/absolute/path/to/claude-code-docs/dist/index.js"]
    }
  }
}

Tests

Run: npm test

The suite covers parser, chunker, loader, lifecycle, fetcher, metadata, and cache behavior. Special cases:

tests/integration.test.ts is skipped unless INTEGRATION=1.
tests/corpus-validation.test.ts depends on a populated content cache.

Known Limitations

Stdio transport only; no HTTP/SSE transport.
No background refresh loop; use reload_docs for refreshes.
Category filtering is limited to the predefined list above.

Available Tools

4 tools

dump_index_metadataDump Index MetadataA

Dump full BM25 index metadata: categories, chunk IDs, headings, code literals, config keys, and distinctive terms. No parameters.

Inputs: no named parameters. Returns: built_at, categories, docs_epoch, index_version, +1 more

get_statusGet Server StatusA

Get current status of the claude-code-docs server: trust mode, documentation source, index age, and any active warnings.

Inputs: no named parameters. Returns: docs_url, is_loading, trust_mode, docs_origin, +7 more

reload_docsReload Claude Code DocsA

Force reload of Claude Code documentation. Use after editing docs to refresh search index.

Inputs: no named parameters.

search_docsSearch Claude Code DocsA

Search Claude Code documentation (extensions, setup, security, providers, IDE integration, CI/CD, and more). Use specific queries.

Inputs: query (required), limit, category. Returns: meta, error, results

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

Deploy Server

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

A4.1/5.0

Scored 2026-07-30 16:03 across 4 tools

Disambiguation5/5

Each tool has a clearly distinct purpose: reloading docs, searching, getting server status, and dumping index metadata. No overlap or ambiguity.

Naming Consistency5/5

All tool names follow a consistent verb_noun pattern using snake_case (e.g., reload_docs, search_docs, get_status, dump_index_metadata), making them predictable.

Tool Count5/5

Four tools is well-scoped for a documentation management server, covering all necessary operations without being excessive or insufficient.

Completeness4/5

The tool set covers the core lifecycle: reloading, searching, status, and metadata inspection. A minor gap could be a tool to add or update documentation sources, but current set is largely complete.

Maintenance

ActivitySlowing

ResponsivenessNo recent community issues

Resources

Related MCP Connectors

Agent DocsA
io.github.KonstantinStarovoytov
Search the official docs of Claude Code, Cursor, OpenAI Codex and MCP, refreshed daily.
Documentation Access Search Developer Tools
21
https://agent-docs-mcp.onrender.com/mcp/
Claude Platform DocsA
com.claude.platform
Search and read the Claude Platform documentation and API reference.
Documentation Access Search
41
https://platform.claude.com/docs/mcp
ref-tools-mcpA
tools.ref
Token-efficient search for coding agents over public and private documentation.
Documentation Access Search Coding Agents
221,184
https://api.ref.tools/mcp
Vector Panda DocumentationA
com.vectorpanda
Search and read Vector Panda docs: API operations, pricing, storage tiers, measured benchmarks.
Documentation Access Vector Databases
81
https://www.vectorpanda.com/mcp

Related MCP Servers

Semantic Search MCP Server
RAG Systems Code Analysis Search
camilojourney
F
license
Not graded
quality
B
maintenance
Provides hybrid semantic and keyword code search for Claude Code using BM25 and vector retrieval. It enables indexing and searching local codebases with language-aware chunking and local embeddings.
Updated a month ago (2026-10-06 16:44 UTC)
-
MCP Context Manager
Developer Tools Code Analysis Search
transparentlyok
A
license
A
quality
D
maintenance
Enables efficient code navigation and retrieval through natural language search, BM25 ranking, and fuzzy matching across multiple programming languages. It drastically reduces token usage by allowing Claude to query specific code symbols and logic instead of reading entire files.
Updated 5 months ago (2026-06-07 02:12 UTC)
13
100 npm
13
MIT
lore
Knowledge & Memory RAG Systems Search
hyunjae-labs
A
license
A
quality
D
maintenance
Semantic search across Claude Code conversations. Hybrid vector + keyword search, fully local, background indexing.
Updated 6 months ago (2026-05-13 04:37 UTC)
6
21 npm
11
MIT
code-rag-mcp
RAG Systems Search
qduc
A
license
A
quality
D
maintenance
Enables semantic search over codebases using natural language queries, returning relevant code snippets with source locations. Integrates with Claude Code for automatic codebase exploration.
Updated 6 months ago (2026-05-15 07:58 UTC)
1
1
MIT

claude-code-docs MCP Server

Problem Statement

Quick Start

How It Works

Configuration

Tools

search_docs

reload_docs

get_status

dump_index_metadata

Resources

Transport

Client Configuration

Tests

Known Limitations

Available Tools

Tool Schema Changelog

TDQS

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

Semantic Search MCP Server

MCP Context Manager

lore

code-rag-mcp

`search_docs`

`reload_docs`

`get_status`

`dump_index_metadata`