docs-mcp-server
Grounded Docs (docs-mcp-server) aims to reduce hallucinations and outdated answers by giving an AI coding assistant a personal, current documentation index. It fetches official documentation from websites, GitHub, npm, PyPI and local files, and the README presents it as an open-source alternative to Context7, Nia and Ref.Tools. Queries can target the exact library version in your project, and everything runs on your own machine so your code stays on your network. It can index websites, GitHub repositories, local folders and zip archives, and processes HTML, Markdown, PDF, Office documents, OpenDocument, RTF, EPUB, Jupyter notebooks and 90+ source code languages.
There are two ways to use it. The CLI-first path needs Node.js 22 or newer: `npx @arabold/docs-mcp-server@latest scrape react https://react.dev/reference/react` indexes a library, and the repository ships Agent Skills that teach assistants to use the CLI. For a long-running endpoint, run `npx @arabold/docs-mcp-server@latest`, add documentation in the web UI at `http://localhost:6280`, and point your MCP client at `http://localhost:6280/mcp` (Streamable HTTP). An embedding model is optional but recommended for semantic search, for example with `OPENAI_API_KEY`, or Ollama, Gemini or Azure instead. It is MIT licensed.
Features
Why choose it
Trade-offs
Maintenance check
- Last commit
- 2026-11-01
- Commits, last 90 days
- 100+
- Releases, last 90 days
- 7
- Latest release
- v3.4.1 (2026-10-25)
- Open issues
- 75
- Recent issues with at least one comment
- 2/8
Oldest week on the left; the latest four weeks are orange. Source: GitHub commit activity.
Status rule: archived on GitHub = Archived; last commit within 90 days = Active; 91 to 365 days = Slowing; older = Stale. All figures come from the GitHub API on the date shown.
Most discussed open issues
- #400 Consider use of CloakBrowser instead of Playwright5 comments · 2026-05-13
- #509 feat: Storage management in Web Dashboard, reclaimable space visibility, and post-scrape WAL cleanup3 comments · 2026-09-21
- #389 Feature request: PostGreSQL as external database3 comments · 2026-04-15
- #508 Markdown served as text/plain bypasses the Markdown pipeline2 comments · 2026-09-21
- #608 Not starting on Macos (problem with better_sqlite3)1 comments · 2026-11-03
Issue titles are quoted from GitHub. Open the link to check whether a problem still applies to the version you use.
Who it fits
- You need internal or private documentation indexed alongside public libraries.
- Everything must stay on your machine or network.
- You want answers for the exact library version your project uses.
- You do not want to scrape and index each library yourself: hosted indexes come ready-made.
- You cannot run Node.js 22 or newer.
- You want the best search quality with no embedding model or API key: the README says search is better with embeddings.
How it differs
Context7 is hosted and ready to use, but only for public libraries in its index. docs-mcp-server is local and needs indexing, but handles private docs.
Ref is a hosted search tuned to return small slices of docs. docs-mcp-server keeps the index and queries on your machine.
Compatibility
Quick start
Use cases
Alternatives
Featured in these lists
Comments
No comments yet. Be the first!