MCP Documentation Server

Local-first document management and semantic search for AI coding agents. No external databases, no cloud APIs, no vendor lock-in.

Unlike other MCP servers that are CLI-only, this one ships with a full web dashboard — browse, search, upload, and manage your knowledge base from your browser. Every MCP tool is also exposed as a REST API, giving AI agents a lean, schema-free interface.

• 🏠 Runs fully offline — Orama vector DB with local AI embeddings (Transformers.js)
• 🌐 Built-in Web UI — starts automatically on port 3080 alongside the MCP server
• 🔍 Hybrid search — full-text + vector similarity with parent-child chunking
• 🤖 Optional AI search — Google Gemini for advanced document analysis (bring your own key)
• 📁 Drag & drop uploads — .txt, .md, .pdf support
• 📦 Published on the MCP Registry — installable via npx, no clone needed

Quick Start

{
  "mcpServers": {
    "documentation": {
      "command": "npx",
      "args": ["-y", "@andrea9293/mcp-documentation-server"]
    }
  }
}

Open your browser at http://localhost:3080 — the web UI starts automatically.

🤖 Agent Skill (REST API) — recommended for AI agents

Every MCP tool is also accessible via the REST API on http://127.0.0.1:3080/api/. This is the recommended way to interact from AI agents (Claude Code, OpenCode, Gemini CLI, Cursor) because it avoids loading MCP tool schemas into the conversation context — only the response JSON enters.

curl -s http://127.0.0.1:3080/api/config
curl -s http://127.0.0.1:3080/api/documents
curl -s -X POST http://127.0.0.1:3080/api/search-all \
  -H "Content-Type: application/json" \
  -d '{"query": "your search", "limit": 5}'

A ready-to-use skill is included at skills/documentation-server/SKILL.md — it teaches your agent every endpoint with examples. Install it:

npx skills add https://github.com/andrea9293/mcp-documentation-server --skill documentation-server

Basic workflow

1. Add documents using add_document or place .txt / .md / .pdf files in the uploads folder and call process_uploads.
2. Search across everything with search_all_documents, or within a single document with search_documents.
3. Use get_context_window to fetch neighboring chunks and give the LLM broader context.

Web UI

The web interface starts automatically on port 3080 when the MCP server launches. From the web UI you can:

• 📊 Dashboard — overview of all documents and stats
• 📄 Documents — browse, view, and delete documents
• ➕ Add Document — create documents with title, content, and metadata
• 🔍 Search All — semantic search across all documents
• 🎯 Search in Doc — search within a specific document
• 🤖 AI Search — Gemini-powered analysis (if GEMINI_API_KEY is set)
• 📁 Upload Files — drag & drop files and process them into the knowledge base
• 🪟 Context Window — explore chunks around a specific index

Configure an MCP client

Minimal

{
  "mcpServers": {
    "documentation": {
      "command": "npx",
      "args": ["-y", "@andrea9293/mcp-documentation-server"]
    }
  }
}

With environment variables (all optional)