MCP Docs Server

MCP server for documentation search with automatic web indexing.

Usage via npx (Recommended)

Run the MCP server directly without installation:

# STDIO mode (for MCP client integration)
SEED_URLS="Docs|https://example.com/docs|sidebar|0" TRANSPORT=stdio npx @pgupta1795/mcp-docs

# HTTP mode
SEED_URLS="Docs|https://example.com/docs|sidebar|0" TRANSPORT=http npx @pgupta1795/mcp-docs

MCP Client Configuration (npx)

{
  "mcpServers": {
    "docs": {
      "command": "npx",
      "args": ["-y", "@pgupta1795/mcp-docs"],
      "env": {
        "TRANSPORT": "stdio",
        "SEED_URLS": "Docs|https://example.com/docs|sidebar|0"
      }
    }
  }
}

Quick Start (Local Development)

npm install
npm run build

Running the Server

STDIO Mode

TRANSPORT=stdio npm run start
# Or for development:
npm run dev:stdio

HTTP Mode

TRANSPORT=http npm run start
# Or for development:
npm run dev:http

HTTP endpoint: http://localhost:5004/docs/mcp

MCP Client Configuration

STDIO Mode

{
  "mcpServers": {
    "mcp-docs": {
      "command": "node",
      "args": ["dist/index.js"],
      "cwd": "C:/path/to/mcp-docs",
      "env": {
        "TRANSPORT": "stdio",
        "SEED_URLS": "TVC Classic|https://products.technia.com/app/docs/tvc-documentation-2025.4.0/tvc/install/index.html|sidebar|0"
      }
    }
  }
}

HTTP Mode

{
  "mcpServers": {
    "mcp-docs": {
      "type": "http",
      "url": "http://localhost:5004/docs/mcp"
    }
  }
}

Environment Variables

| Variable | Default | Description | | ------------------- | ------------------------- | -------------------------------------------------- | | TRANSPORT | http | Transport mode: stdio or http | | PORT | 5004 | HTTP server port | | SEED_URLS | required | Documentation sources (see format below) | | DB_PATH | ./data/mcp-docs.db | SQLite database path | | INIT_ON_START | true | Auto-index on startup | | CRAWL_MAX_PAGES | 1000 | Max pages per source | | CRAWL_MAX_DEPTH | 5 | Max crawl depth | | CACHE_SIZE | 100 | LRU cache size | | LOG_LEVEL | info | Log level: debug, info, warn, error | | LOG_PATH | - | Optional log file path | | SEARCH_MODE | SEMANTIC_ONLY | Search mode: FTS_ONLY, SEMANTIC_ONLY, HYBRID | | EMBEDDING_MODEL | Xenova/all-MiniLM-L6-v2 | Embedding model for semantic search | | SEMANTIC_TOP_K | 20 | Top K results for semantic search | | HYBRID_FTS_WEIGHT | 0.4 | FTS weight in hybrid mode (0-1) |

SEED_URLS Format

name|url|navigationMode|recrawlIntervalHours

• navigationMode: sidebar, navbar, or auto
• recrawlIntervalHours: 0 = never, 24 = daily

Example:

SEED_URLS=TVC Classic|https://products.technia.com/app/docs/tvc-documentation-2025.4.0/tvc/install/index.html|sidebar|0,TIF Cloud|https://forseven.tifdemo.technia.cloud/docs/tif-cloud/Current/main/index.html|auto|24