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": "TVC Classic 2025.4.0|https://products.technia.com/app/docs/tvc-documentation-2025.4.0/tvc/install/index.html|navbar|0,TVC Helium 2025.4.0|https://products.technia.com/app/docs/tvc-helium-documentation-2025.4.0/index.html|navbar|0,TIF Classic 2025.4.0|https://products.technia.com/app/docs/tif-documentation-2025.4.0/tif-classic/2025.4.0/main/index.html|sidebar|0,TIF Cloud|https://forseven.tif.technia.cloud/docs/tif-cloud/Current/main/index.html|sidebar|0",
        "SEARCH_MODE": "SEMANTIC_ONLY",
        "DB_PATH": "C:/GBS/Search_Tool/mcp-docs/data/mcp-docs.db"
      }
    }
  }
}

---

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