Docsearch Mcp

by PatrickKoss

278 downloads
Not rated
GitHub

About

A local‑first document search and indexing system that provides hybrid semantic + keyword search across local files (including PDFs) and Confluence pages through the Model Context Protocol (MCP). It is designed for AI assistants like Claude Code/Desktop to access documentation…

Details

Author
PatrickKoss
Downloads
278
Categories
Other

- Hybrid search combining full‑text and vector similarity.
- Index local files, PDFs, and Confluence spaces.
- AI‑powered image description and search for diagrams.
- Database flexibility: SQLite (local‑first) or PostgreSQL (scalable).
- Real‑time file watching with automatic re‑indexing.
- Multiple output formats: text, JSON, and YAML.

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Docsearch Mcp
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install globally with npm install -g docsearch-mcp or use with npx. Add the server to your MCP client configuration with the command npx docsearch-mcp start. Use CLI commands such as docsearch-mcp ingest files to index documents and docsearch-mcp search "query" to search. Docker images are also available for containerized deployment.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "docsearch mcp": {
            "docsearch": {
                "command": "npx",
                "args": [
                    "docsearch-mcp",
                    "start"
                ],
                "env": {
                    "OPENAI_API_KEY": "your-openai-key",
                    "EMBEDDINGS_PROVIDER": "openai",
                    "FILE_ROOTS": ".,../other-project",
                    "DB_PATH": "/path/to/your/index.db"
                }
            }
        }
    }
}

McpServers

{
    "docsearch": {
        "command": "npx",
        "args": [
            "docsearch-mcp",
            "start"
        ],
        "env": {
            "OPENAI_API_KEY": "your-openai-key",
            "EMBEDDINGS_PROVIDER": "openai",
            "FILE_ROOTS": ".,../other-project",
            "DB_PATH": "/path/to/your/index.db"
        }
    }
}

docsearch-mcp

TypeScript
Node.js
MCP

A local-first document search and indexing system that provides hybrid semantic + keyword search across local files (including PDFs) and Confluence pages through the Model Context Protocol (MCP). Perfect for AI assistants like Claude Code/Desktop to access your documentation, codebase, and research materials.

✨ Features

- 🔍 Hybrid Search: Combines full-text search (FTS) with vector similarity for optimal results
- 📁 Multi-Source: Index local files (code, docs, PDFs) and Confluence spaces
- 📄 PDF Support: Extract and search text from PDF documents with metadata preservation
- 🖼️ Image Search: AI-powered image description and search for diagrams, screenshots, and charts
- 🗄️ Database Flexibility: Support for SQLite (local-first) and PostgreSQL (scalable)
- 🤖 MCP Integration: Seamless integration with Claude Code and other MCP-compatible tools
- 💻 CLI Tool: Standalone command-line interface with multiple output formats
- ⚡ Real-time Updates: File watching with automatic re-indexing
- 🎯 Smart Chunking: Intelligent text chunking for code, documentation, and PDFs
- 📊 Multiple Output Formats: Text, JSON, and YAML output for search results
- 🔒 Secure: API keys and sensitive data stay on your machine

🚀 Installation & Usage

npm Package

```bash

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.