Guides

Setup MCP

How to add vibe-hnindex to different AI tools. The MCP configuration is the same everywhere — only the file path differs.

Configuration Template

Here's the standard config block you'll add to each tool:

{
  "mcpServers": {
    "vibe-hnindex": {
      "command": "npx",
      "args": ["-y", "vibe-hnindex"],
      "env": {
        "OLLAMA_URL": "http://localhost:11434",
        "OLLAMA_MODEL": "bge-m3:567m",
        "QDRANT_URL": "http://localhost:6333"
      }
    }
  }
}

For Qdrant Cloud, add QDRANT_API_KEY and use your HTTPS cluster URL. See the Installation guide for details.

Per-Platform Setup

Google Antigravity

File	`mcp_config.json`
Windows	`C:\Users\<you>\.gemini\antigravity\mcp_config.json`
macOS/Linux	`~/.gemini/antigravity/mcp_config.json`
From UI	⋮ → MCP → Manage MCP Servers → View raw config

Verify Your Setup

Restart your AI tool after editing the MCP config
Look for vibe-hnindex in your tool's MCP server list
Try indexing a project: Index the codebase at /path, name it test
Run diagnostics: server_diagnostics()

Common Issues

Ollama not reachable

Ensure ollama serve is running on the configured URL

Qdrant auth error (401)

Set QDRANT_API_KEY for Qdrant Cloud

npm install fails (Windows)

Use Node 20 LTS or install VS Build Tools

Server not showing up

Check file path and JSON syntax; restart tool

Full troubleshooting: Troubleshooting Guide

PreviousBenchmark

NextPerformance