DevDocs MCP server

Free, private, UI-based software documentation context management server. Designed with software developers in mind.
Back to servers
Setup instructions
Provider
Cyberagi Inc
Release date
Apr 02, 2025
Language
TypeScript
Stats
1.8K stars

DevDocs is a powerful tool that transforms documentation research into an efficient process. It intelligently crawls technical documentation websites, extracts meaningful content, and organizes it into a searchable format accessible through an MCP server. This allows developers to implement new technologies faster without spending weeks reading documentation.

Installation Guide

Prerequisites

  • Docker installed on your system
  • Git for cloning the repository

Docker Installation (Recommended)

For Mac/Linux users:

# Clone the repository
git clone https://github.com/cyberagiinc/DevDocs.git

# Navigate to the project directory
cd DevDocs

# Start all services using Docker
./docker-start.sh

For Windows users:

# Clone the repository
git clone https://github.com/cyberagiinc/DevDocs.git

# Navigate to the project directory
cd DevDocs

# Start all services using Docker
docker-start.bat

This command will:

  1. Create all necessary directories
  2. Set appropriate permissions
  3. Build and start all Docker containers
  4. Monitor the services to ensure they're running properly

Accessing the Services

Once the services are running, you can access:

Troubleshooting Installation

Windows Permission Issues

If you encounter permission issues on Windows, you may need to run the script as administrator or manually set permissions on the logs, storage, and crawl_results directories.

Manually setting permissions via Command Prompt (as Administrator):

icacls logs /grant Everyone:F /T
icacls storage /grant Everyone:F /T
icacls crawl_results /grant Everyone:F /T

Viewing Logs

For debugging purposes, you can view container logs:

# View logs from a specific container
docker logs devdocs-frontend
docker logs devdocs-backend
docker logs devdocs-mcp
docker logs devdocs-crawl4ai

# Follow logs in real-time
docker logs -f devdocs-backend

Using DevDocs

Basic Usage

  1. Navigate to the frontend UI at http://localhost:3001
  2. Enter the URL of the technical documentation you want to crawl
  3. Choose your desired crawl depth (1-5 levels)
  4. Start the crawl process
  5. Once completed, the content will be available for querying through the MCP server

Configuring Claude Integration

DevDocs is designed to work seamlessly with Claude. To set up the integration:

  1. Open the "Modes" Interface in Roo Code
  2. Create a new Mode-Specific Prompt called "Research_MCP"

Setting Up Cline/Roo Cline for Development

Follow these steps to configure Cline/Roo Cline for optimal use with DevDocs:

  1. In Roo Code, click the + to create a new Mode-Specific Prompt
  2. Name it "Research_MCP"
  3. Configure the Role Definition and Mode-Specific Custom Instructions as provided in the documentation

Working with the MCP Server

The MCP server can be interacted with through various utility scripts:

# Verify the MCP server's health
./check_mcp_health.sh

# Restart and test MCP configuration
./restart_and_test_mcp.sh

Crawl4AI Usage

For advanced crawling options, you can use the Crawl4AI service directly:

# Check the status of Crawl4AI
./check_crawl4ai.sh

# Run Crawl4AI in debug mode
./debug_crawl4ai.sh

Viewing Results

To view crawl results in a formatted view:

./view_result.sh

Features Overview

Intelligent Crawling Capabilities

  • Smart depth control (1-5 levels)
  • Automatic link discovery
  • Selective crawling of specific content
  • Child URL detection

Content Processing

  • Clean extraction without unnecessary elements
  • Export to MD or JSON for LLM fine-tuning
  • Structured output organization
  • MCP Server Integration for AI processing

Performance Features

  • Parallel processing of multiple pages
  • Smart caching to avoid duplicate content
  • Support for lazy loading in modern web apps
  • Respectful rate limiting

How to install this MCP server

For Claude Code

To add this MCP server to Claude Code, run this command in your terminal:

claude mcp add-json "devdocs" '{"command":"docker","args":["run","--name","devdocs-mcp","--network","host","devdocs-mcp:latest"]}'

See the official Claude Code MCP documentation for more details.

For Cursor

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.

Adding an MCP server to Cursor globally

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": {
        "devdocs": {
            "command": "docker",
            "args": [
                "run",
                "--name",
                "devdocs-mcp",
                "--network",
                "host",
                "devdocs-mcp:latest"
            ]
        }
    }
}

Adding an MCP server to a project

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.

How to use the MCP server

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.

For Claude Desktop

To add this MCP server to Claude Desktop:

1. Find your configuration file:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
  • Linux: ~/.config/Claude/claude_desktop_config.json

2. Add this to your configuration file:

{
    "mcpServers": {
        "devdocs": {
            "command": "docker",
            "args": [
                "run",
                "--name",
                "devdocs-mcp",
                "--network",
                "host",
                "devdocs-mcp:latest"
            ]
        }
    }
}

3. Restart Claude Desktop for the changes to take effect

Want to 10x your AI skills?

Get a free account and learn to code + market your apps using AI (with or without vibes!).

Nah, maybe later