🚀 Code Indexer MCP Server

Transform your AI's understanding of code! 🤖✨

Make any AI model instantly understand your entire codebase with lightning-fast semantic search. No more "find that function" - just ask naturally and get precise results!

✨ What Makes This Special?

🧠 Talk to Your Code - Ask "find the authentication logic" instead of grep-ing ⚡ Blazing Fast - Powered by Ollama embeddings + Qdrant vector magic 🔄 Live Updates - Code changes? We've got you covered automatically 🎯 Zero Setup Hassles - We fixed all the config headaches for you! 🛡️ Bulletproof - Production-ready with comprehensive error handling 🎨 VS Code Native - Seamlessly integrates with your workspace 🚫 Smart Filtering - Advanced exclusion system ignores irrelevant files automatically

🎯 Perfect For

• AI Pair Programming - Give your AI assistant superpowers
• Large Codebases - Navigate massive projects effortlessly
• Code Reviews - Find similar patterns and implementations
• Documentation - Auto-discover relevant examples
• Refactoring - Locate all usage patterns instantly

⚡ Quick Start (3 minutes!)

What You Need

• Node.js 18+ (check with node --version)
• Ollama with nomic-embed-text model
• Qdrant running (Docker: docker run -p 6333:6333 qdrant/qdrant)

Get Running

# 1. Clone and install
git clone https://github.com/CoderDayton/code-indexer
cd code-indexer
npm install

# 2. Copy the example config (we made this super easy!)
cp .env.example .env

# 3. Start your engines
npm run build && npm start

🔧 Quick Config

Your .env file is pre-configured with sensible defaults:

# Already set up for local development!
QDRANT_URL=http://localhost:6333
OLLAMA_HOST=http://localhost:11434
OLLAMA_MODEL=nomic-embed-text:latest
COLLECTION_NAME=code_index
# BASE_DIRECTORY=auto-detected!

# Smart file exclusions (NEW!)
USE_ADVANCED_EXCLUSIONS=true
EXCLUSION_CONFIG_PATH=indexer-exclusions.json

🎮 Available Commands

Once running, your AI can use these tools:

| Tool | What it does | Example | |------|-------------|---------| | index_files | Index specific files/folders | "Index my src/ directory" | | search_code | Find code semantically | "Find JWT validation logic" | | reindex_all | Refresh everything | "Reindex after big refactor" | | start_watching | Auto-update on changes | "Watch for file changes" | | get_status | Check what's indexed | "Show indexing status" |

🚫 Smart File Exclusions (NEW!)

No more indexing junk! Our advanced exclusion system automatically filters out build artifacts, dependencies, and temporary files.

🎯 What Gets Excluded Automatically

• Build Artifacts: dist/, build/, target/, bin/, obj/
• Dependencies: node_modules/, vendor/, Pods/, .gradle/
• Version Control: .git/, .svn/, .hg/
• Temporary Files: *.log, *.tmp, *.cache, *.pid
• System Files: .DS_Store, Thumbs.db, desktop.ini
• Lock Files: package-lock.json, yarn.lock, Cargo.lock
• Large Files: Files over 50MB (configurable)
• Binary Files: Executables, images, compiled code
• Minified Code: *.min.js, *.bundle.js

🔧 Language-Specific Intelligence

The system automatically detects your project type and applies smart exclusions:

{
  "javascript": ["node_modules/**", "*.min.js", ".next/**"],
  "python": ["__pycache__/**", "*.pyc", ".venv/**"],
  "java": ["target/**", "*.class", "*.jar"],
  "rust": ["target/**", "Cargo.lock"],
  "csharp": ["bin/**", "obj/**", "*.dll"]
}

⚙️ Easy Customization

Create your own indexer-exclusions.json:

{
  "exclusions": {
    "folders": {
      "patterns": ["my-custom-folder/**", "temp/**"]
    },
    "files": {
      "patterns": ["*.secret", "*.private"]
    },
    "size_limits": {
      "max_file_size_mb": 25
    }
  },
  "inclusion_overrides": {
    "patterns": ["README.*", "LICENSE*", "*.md"]
  }
}

🔄 Legacy Support

Prefer the old way? No problem:

USE_ADVANCED_EXCLUSIONS=false
IGNORE_PATTERNS=node_modules/**,dist/**,*.log

🏗️ What We Fixed For You

Fresh & Clean! This version has been completely reorganized for maximum clarity.

✅ Unified Config System - No more scattered config files ✅ Rock-Solid Validation - Zod schemas catch config errors early ✅ Clean Architecture - Easy to understand and extend ✅ Comprehensive Tests - Everything is tested and verified

🚀 Immediate Indexing on Startup

Control whether indexing kicks off automatically when the server starts using an environment flag.

• Variable: IMMEDIATE_INDEXING_ENABLED
• Type: boolean
• Accepted values: true, false, 1, 0, yes, no, on, off (case-insensitive)
• Default: false if unset or invalid
• Legacy aliases (deprecated, still honored): IMMEDIATE_INDEXING, START_INDEXING_ON_STARTUP
• Precedence: IMMEDIATE_INDEXING_ENABLED takes priority if both are set

Example:

IMMEDIATE_INDEXING_ENABLED=true

Logs show whether the initial indexing was started or skipped.

✅ Zero Legacy Cruft - Removed all the old, confusing files ✅ Better Error Messages - Actually helpful when things go wrong ✅ Smart File Exclusions - Advanced filtering system ignores irrelevant files ✅ Language Intelligence - Automatically detects and excludes language-specific artifacts

🛠️ Development Mode

npm run dev     # Hot reload during development
npm test        # Run the test suite
npm run build   # Create production build

🏛️ Architecture Overview

🎯 MCP Server     ➜  Talks to AI models
🧠 Code Indexer  ➜  Processes your files
🔍 Vector Store  ➜  Qdrant similarity search
👁️ File Watcher  ➜  Keeps everything fresh
⚙️ Config System ➜  Zod-validated settings

🐛 Troubleshooting

"Connection refused" → Check if Qdrant/Ollama are running "Model not found" → Run ollama pull nomic-embed-text "Permission denied" → Make sure BASE_DIRECTORY is readable "No files found" → Check your exclusion patterns in indexer-exclusions.json "Config file error" → Validate your JSON syntax or set USE_ADVANCED_EXCLUSIONS=false "Too many files excluded" → Review inclusion overrides or adjust exclusion patterns Still stuck? → Check the logs in ./logs/ directory

📚 Configuration Files

| File | Purpose | Documentation | |------|---------|---------------| | .env | Environment variables | Copy from .env.example | | indexer-exclusions.json | Advanced file exclusions | See EXCLUSION_SYSTEM.md | | tsconfig.json | TypeScript configuration | Standard TS config | | package.json | Dependencies and scripts | Standard Node.js config |

📖 Detailed Documentation

• EXCLUSION_SYSTEM.md - Complete guide to the advanced exclusion system
• .env.example - All available environment variables with examples
• indexer-exclusions.json - Default exclusion configuration

🎉 What's Next?

• 🔌 VS Code Extension - Direct integration coming soon
• 🌐 Web UI - Browse your indexed code visually
• 🔄 Git Integration - Index only changed files on commits
• 📊 Analytics - See what code patterns are most queried
• 🎯 Smart Exclusions - AI-powered exclusion suggestions
• 🔍 Exclusion Preview - See what files will be excluded before indexing

📜 License

MIT License - Build amazing things! 🚀

Made with ❤️ by malu

💡 Pro tip: Try asking your AI "show me all error handling patterns" after indexing - you'll be amazed!