🚀 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!)

$3

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

$3

bash

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





$3



Your

.env

 file is pre-configured with sensible defaults:

env

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.



$3



- 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





$3



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

json

{

  "javascript": ["node_modules/", "*.min.js", ".next/"],

  "python": ["__pycache__/", "*.pyc", ".venv/"],

  "java": ["target/*", ".class", "*.jar"],

  "rust": ["target/**", "Cargo.lock"],

  "csharp": ["bin/", "obj/", "*.dll"]

}





$3



Create your own

indexer-exclusions.json

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"]

  }

}





$3



Prefer the old way? No problem:

env

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

$3



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:

env

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

bash

npm run dev     # Hot reload during development

npm test        # Run the test suite

npm run build   # Create production build





🏛️ Architecture Overview

text

🎯 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 |

$3

- 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! 🚀

---

$3

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

🚀 Code Indexer MCP Server

✨ What Makes This Special?

🎯 Perfect For

⚡ Quick Start (3 minutes!)

$3

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

$3

bash

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





$3



Your

.env

 file is pre-configured with sensible defaults:

env

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.



$3



- 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





$3



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

json

{

  "javascript": ["node_modules/", "*.min.js", ".next/"],

  "python": ["__pycache__/", "*.pyc", ".venv/"],

  "java": ["target/*", ".class", "*.jar"],

  "rust": ["target/**", "Cargo.lock"],

  "csharp": ["bin/", "obj/", "*.dll"]

}





$3



Create your own

indexer-exclusions.json

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"]

  }

}





$3



Prefer the old way? No problem:

env

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

$3



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:

env

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

bash

npm run dev     # Hot reload during development

npm test        # Run the test suite

npm run build   # Create production build





🏛️ Architecture Overview

text

🎯 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 |

$3

🎉 What's Next?

📜 License

MIT License - Build amazing things! 🚀

---

$3

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