Docy is a Model Context Protocol (MCP) server that provides AI assistants with direct access to technical documentation. It allows AI tools to search and retrieve content from documentation websites in real-time, ensuring accuracy and eliminating issues like outdated information or rate limits.
No specific installation is needed when using uv
. Simply use uvx
to run the server directly:
uvx mcp-server-docy
Install via pip:
pip install mcp-server-docy
Then run as a script:
DOCY_DOCUMENTATION_URLS="https://docs.crawl4ai.com/,https://react.dev/" python -m mcp_server_docy
Pull and run the Docker image:
docker pull oborchers/mcp-server-docy:latest
docker run -i --rm -e DOCY_DOCUMENTATION_URLS="https://docs.crawl4ai.com/,https://react.dev/" oborchers/mcp-server-docy
Add to your Claude settings:
Using uvx:
"mcpServers": {
"docy": {
"command": "uvx",
"args": ["mcp-server-docy"],
"env": {
"DOCY_DOCUMENTATION_URLS": "https://docs.crawl4ai.com/,https://react.dev/"
}
}
}
Using Docker:
"mcpServers": {
"docy": {
"command": "docker",
"args": ["run", "-i", "--rm", "oborchers/mcp-server-docy:latest"],
"env": {
"DOCY_DOCUMENTATION_URLS": "https://docs.crawl4ai.com/,https://react.dev/"
}
}
}
Using pip installation:
"mcpServers": {
"docy": {
"command": "python",
"args": ["-m", "mcp_server_docy"],
"env": {
"DOCY_DOCUMENTATION_URLS": "https://docs.crawl4ai.com/,https://react.dev/"
}
}
}
Add to your User Settings (JSON) file or .vscode/mcp.json
in your workspace:
Using uvx:
{
"mcp": {
"servers": {
"docy": {
"command": "uvx",
"args": ["mcp-server-docy"],
"env": {
"DOCY_DOCUMENTATION_URLS": "https://docs.crawl4ai.com/,https://react.dev/"
}
}
}
}
}
Using Docker:
{
"mcp": {
"servers": {
"docy": {
"command": "docker",
"args": ["run", "-i", "--rm", "oborchers/mcp-server-docy:latest"],
"env": {
"DOCY_DOCUMENTATION_URLS": "https://docs.crawl4ai.com/,https://react.dev/"
}
}
}
}
}
Configure using environment variables:
DOCY_DOCUMENTATION_URLS
: Comma-separated list of documentation URLsDOCY_DOCUMENTATION_URLS_FILE
: Path to file with URLs (default: ".docy.urls")DOCY_CACHE_TTL
: Cache time-to-live in seconds (default: 432000)DOCY_CACHE_DIRECTORY
: Path to cache directory (default: ".docy.cache")DOCY_USER_AGENT
: Custom User-Agent for HTTP requestsDOCY_DEBUG
: Enable debug logging ("true", "1", "yes", or "y")DOCY_SKIP_CRAWL4AI_SETUP
: Skip crawl4ai-setup at startupDOCY_TRANSPORT
: Transport protocol ("sse" or "stdio", default: "stdio")DOCY_HOST
: Host address to bind to (default: "127.0.0.1")DOCY_PORT
: Port number (default: 8000)Instead of environment variables, create a .docy.urls
file with one URL per line:
https://docs.crawl4ai.com/
https://react.dev/
# Lines starting with # are comments
https://docs.python.org/3/
This file supports hot-reload, allowing you to add or modify URLs without restarting the server.
list_documentation_sources_tool
: Lists all available documentation sources
fetch_documentation_page
: Fetches content from a documentation URL as markdown
url
(string, required): The URL to fetch content fromfetch_document_links
: Fetches all links from a documentation page
url
(string, required): The URL to fetch links fromTo use Docy effectively with Claude, include these prompts:
# Verify implementation against documentation
Are we implementing Crawl4Ai scrape results correctly? Let's check the documentation.
# Explore API usage patterns
What do the docs say about using mcp.tool? Show me examples from the documentation.
# Compare implementation options
How should we structure our data according to the React documentation? What are the best practices?
To ensure Claude prioritizes Docy, add these guidelines to your CLAUDE.md
file:
## Documentation Guidelines
- When checking documentation, prefer using Docy over WebFetchTool
- Use list_documentation_sources_tool to discover available documentation sources
- Use fetch_documentation_page to retrieve full documentation pages
- Use fetch_document_links to discover related documentation
If you encounter "Tool not found" errors in Claude Code CLI:
.docy.urls
file with your documentation URLsdocker run -i --rm -p 8000:8000 \
-e DOCY_TRANSPORT=sse \
-e DOCY_HOST=0.0.0.0 \
-e DOCY_PORT=8000 \
-v "$(pwd)/.docy.urls:/app/.docy.urls" \
oborchers/mcp-server-docy
.mcp.json
to use the SSE endpoint:{
"mcp": {
"servers": {
"docy": {
"type": "sse",
"url": "http://localhost:8000/sse"
}
}
}
}
Docy automatically caches documentation content:
DOCY_CACHE_TTL
.docy.urls
file is re-read on each request to support hot-reloadingTo add this MCP server to Claude Code, run this command in your terminal:
claude mcp add-json "docy" '{"command":"uvx","args":["mcp-server-docy"],"env":{"DOCY_DOCUMENTATION_URLS":"https://docs.crawl4ai.com/,https://react.dev/"}}'
See the official Claude Code MCP documentation for more details.
There are two ways to add an MCP server to Cursor. The most common way is to add the server globally in the ~/.cursor/mcp.json
file so that it is available in all of your projects.
If you only need the server in a single project, you can add it to the project instead by creating or adding it to the .cursor/mcp.json
file.
To add a global MCP server go to Cursor Settings > Tools & Integrations and click "New MCP Server".
When you click that button the ~/.cursor/mcp.json
file will be opened and you can add your server like this:
{
"mcpServers": {
"docy": {
"command": "uvx",
"args": [
"mcp-server-docy"
],
"env": {
"DOCY_DOCUMENTATION_URLS": "https://docs.crawl4ai.com/,https://react.dev/"
}
}
}
}
To add an MCP server to a project you can create a new .cursor/mcp.json
file or add it to the existing one. This will look exactly the same as the global MCP server example above.
Once the server is installed, you might need to head back to Settings > MCP and click the refresh button.
The Cursor agent will then be able to see the available tools the added MCP server has available and will call them when it needs to.
You can also explicitly ask the agent to use the tool by mentioning the tool name and describing what the function does.
To add this MCP server to Claude Desktop:
1. Find your configuration file:
~/Library/Application Support/Claude/claude_desktop_config.json
%APPDATA%\Claude\claude_desktop_config.json
~/.config/Claude/claude_desktop_config.json
2. Add this to your configuration file:
{
"mcpServers": {
"docy": {
"command": "uvx",
"args": [
"mcp-server-docy"
],
"env": {
"DOCY_DOCUMENTATION_URLS": "https://docs.crawl4ai.com/,https://react.dev/"
}
}
}
}
3. Restart Claude Desktop for the changes to take effect