Docmole
Docmole is an MCP server that lets you query any documentation site from AI assistants like Claude, Cursor, or any MCP-compatible client. The mole digs through docs so you don't have to.
Features
- 🔍 Universal docs support — works with any documentation site
- 🏠 Self-hosted RAG — LanceDB vectors + OpenAI embeddings, no Python needed
- ⚡ Zero-setup mode — instant access to Mintlify-powered sites
- 🧠 Multi-turn conversations — remembers context across questions
- 🔗 WebFetch compatible — links converted to absolute URLs
- 🔌 MCP native — works with Claude, Cursor, and any MCP client
Coming soon
- 🦙 Ollama support — fully local mode, no API keys needed
- 📄 Generic HTML extraction — support for non-Mintlify documentation sites
- 🔄 Incremental updates — only re-index changed pages
Installation
To use Docmole, run it directly with bunx (no install needed):
bunx docmole --help
Or install globally:
bun install -g docmole
Works on macOS, Linux and Windows. Requires Bun runtime.
Getting started
Local RAG Mode (any docs site)
Index and query any documentation site. Requires OPENAI_API_KEY.
# One-time setup — discovers pages and builds vector index
bunx docmole setup --url https://docs.example.com --id my-docs
# Start the MCP server
bunx docmole serve --project my-docs
Add to your MCP client:
{
"mcpServers": {
"my-docs": {
"command": "bunx",
"args": ["docmole", "serve", "--project", "my-docs"]
}
}
}
Mintlify Mode (zero setup)
For sites with Mintlify AI Assistant — no API key needed:
bunx docmole -p agno-v2
{
"mcpServers": {
"agno-docs": {
"command": "bunx",
"args": ["docmole", "-p", "agno-v2"]
}
}
}
CLI
Docmole has a built-in CLI for all operations:
# Mintlify mode (proxy to Mintlify API)
docmole -p <project-id>
# Local RAG mode
docmole setup --url <docs-url> --id <project-id>
docmole serve --project <project-id>
docmole list
docmole stop --project <project-id>
Run docmole --help for all options.
How it works
┌─────────────┐ ┌─────────────┐ ┌──────────────────────┐
│ MCP Client │────▶│ Docmole │────▶│ Embedded: LanceDB │
│ (Claude, │◀────│ MCP Server │◀────│ Mintlify: API proxy │
│ Cursor...) │ └─────────────┘ └──────────────────────┘
└─────────────┘
Local RAG Mode: Crawls documentation, generates embeddings with OpenAI, stores in LanceDB. Hybrid search combines semantic and keyword matching.
Mintlify Mode: Proxies requests to Mintlify's AI Assistant API. Zero setup, instant results.
Known Mintlify Project IDs
Find more: Open DevTools → Network tab → use the AI assistant → look for
leaves.mintlify.com/api/assistant/{project-id}/message
Configuration
Project structure
~/.docmole/
├── projects/
│ └── <project-id>/
│ ├── config.yaml # Project configuration
│ └── lancedb/ # Vector database
└── global.yaml # Global settings
Documentation
See AGENT.md for detailed documentation including:
- Architecture details
- Backend implementations
- Enterprise deployment guides
Contributing
PRs welcome! See the contributing guide for details.
Acknowledgments
- Mintlify for amazing documentation tooling
- Anthropic for Claude and the MCP protocol
- LanceDB for the vector database
License
The Docmole codebase is under MIT license.
