Docsearch Mcp

npm install -g docsearch-mcp

Add to your MCP client configuration:

{
  "mcpServers": {
    "docsearch": {
      "command": "npx",
      "args": ["docsearch-mcp", "start"]
    }
  }
}

For development or customization:

make setup
pnpm install

cp .env.example .env

docsearch-mcp start

When using the official Docker image, create a .env file:

echo "OPENAI_API_KEY=your-openai-key" > .env
echo "FILE_ROOTS=/app/documents" >> .env

Key considerations for Docker deployment:

- Document Volume: Mount your documents directory to /app/documents in the container
- Data Persistence: Mount your data directory to /app/data to persist the SQLite database
- User Permissions: Use --user $(id -u):$(id -g) to avoid permission issues with mounted volumes
- Environment Variables: Pass configuration via .env file or environment variables
- Official Image: Use ghcr.io/patrickkoss/docsearch-mcp:v0.0.2 for production deployments

docker run --rm -i \
-v /absolute/path/to/documents:/app/documents \
-v /absolute/path/to/data:/app/data \
--env-file .env \
--user $(id -u):$(id -g) \
ghcr.io/patrickkoss/docsearch-mcp:v0.0.5

Create a .env file from .env.example and configure:

docsearch ingest files
docsearch ingest confluence
docsearch ingest all --watch
docsearch ingest files --file-roots "./src,./docs" --openai-api-key sk-xxx
docsearch --config prod.env --db-path /data/prod.db ingest all
The CLI supports multiple configuration sources in order of precedence:
1. Command-line arguments (highest priority)

2. Custom config file (--config path/to/.env)

3. .env.local file

4. .env file (lowest priority)
All configuration options are passed via environment variables to the MCP server:
| Environment Variable  | Default  | Description                               |

| --------------------- | -------- | ----------------------------------------- |

| EMBEDDINGS_PROVIDER | openai | Embeddings provider (openai or tei)   |

| OPENAI_API_KEY      | -        | OpenAI API key (required if using OpenAI) |
| Environment Variable         | Default                                                       | Description                              |

| ---------------------------- | ------------------------------------------------------------- | ---------------------------------------- |

| OPENAI_BASE_URL            | -                                                             | OpenAI base URL (for custom endpoints)   |

| OPENAI_EMBED_MODEL         | text-embedding-3-small                                      | OpenAI embedding model                   |

| OPENAI_EMBED_DIM           | 1536                                                        | OpenAI embedding dimension               |

| TEI_ENDPOINT               | -                                                             | Text Embeddings Inference endpoint       |

| FILE_ROOTS                 | .                                                           | File roots to index (comma-separated)    |

| FILE_INCLUDE_GLOBS         | /.{go,ts,tsx,js,py,rs,java,md,mdx,txt,yaml,yml,json,pdf} | File include patterns                    |

| FILE_EXCLUDE_GLOBS         | /{.git,node_modules,dist,build,target}/                 | File exclude patterns                    |

| CONFLUENCE_BASE_URL        | -                                                             | Confluence base URL                      |

| CONFLUENCE_EMAIL           | -                                                             | Confluence email                         |

| CONFLUENCE_API_TOKEN       | -                                                             | Confluence API token                     |

| CONFLUENCE_SPACES          | -                                                             | Confluence spaces (comma-separated)      |

| DB_TYPE                    | sqlite                                                      | Database type (sqlite or postgresql) |

| DB_PATH                    | ./data/index.db                                             | SQLite database path                     |

| POSTGRES_CONNECTION_STRING | -                                                             | PostgreSQL connection string             |

1. Install the package:

2. Create your configuration:

{
  "mcpServers": {
    "docsearch-work": {
      "command": "npx",
      "args": ["docsearch-mcp", "start"],
      "env": {
        "OPENAI_API_KEY": "sk-your-key",
        "FILE_ROOTS": "/work/projects/frontend,/work/projects/backend",
        "FILE_INCLUDE_GLOBS": "/.{ts,tsx,js,py,md,yaml}",
        "DB_PATH": "/work/data/work-index.db",
        "CONFLUENCE_BASE_URL": "https://company.atlassian.net",
        "CONFLUENCE_SPACES": "DEV,API,DOCS"
      }
    },
    "docsearch-personal": {
      "command": "npx",
      "args": ["docsearch-mcp", "start"],
      "env": {
        "OPENAI_API_KEY": "sk-your-key",
        "FILE_ROOTS": "/home/user/projects,/home/user/documents",
        "DB_PATH": "/home/user/.docsearch/personal.db",
        "EMBEDDINGS_PROVIDER": "tei",
        "TEI_ENDPOINT": "http://localhost:8080/embeddings"
      }
    }
  }
}

{
  "mcpServers": {
    "docsearch": {
      "command": "npx",
      "args": ["docsearch-mcp", "start"],
      "env": {
        "OPENAI_API_KEY": "sk-your-key",
        "DB_TYPE": "postgresql",
        "POSTGRES_CONNECTION_STRING": "postgresql://user:pass@localhost:5432/docsearch",
        "FILE_ROOTS": ".,/other/projects"
      }
    }
  }
}

npm install -g docsearch-mcp
echo "OPENAI_API_KEY=sk-your-key-here" > .env

echo "FILE_ROOTS=.,../other-project" >> .env
echo "OPENAI_API_KEY=sk-your-key" > .env

echo "FILE_ROOTS=/app/documents" >> .env
Team Documentation Hub:

Personal Research Setup:

docsearch-mcp ingest files \
--file-roots "/research/papers,/research/reports" \
--file-include-globs "*/.{pdf,docx,md,txt}" \
--openai-embed-model "text-embedding-3-large" \
--openai-embed-dim 3072

docsearch-mcp search "kubernetes deployment" \
--source confluence \
--repo DEVOPS \
--mode keyword