mcp-code-indexer

fluffypony/mcp-code-indexer

3.3

If you are the rightful owner of mcp-code-indexer and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

MCP Code Indexer is a production-ready Model Context Protocol server designed to enhance AI agents' ability to navigate and understand large codebases efficiently.

The MCP Code Indexer is a cutting-edge server solution that addresses the challenges faced by AI agents when interacting with extensive codebases. By providing instant access to intelligent descriptions, semantic search, and context-aware recommendations, it eliminates the need for agents to repeatedly scan files. This server is optimized for high-concurrency environments, ensuring robust database resilience and maintaining a throughput of over 800 writes per second. It is particularly beneficial for AI-powered code review, refactoring tools, documentation generation, and codebase analysis workflows. The MCP Code Indexer streamlines the process of understanding code structure, offering tools for querying file purposes, searching across codebases, and generating project overviews.

Features

  • Instant natural language descriptions for file purposes
  • Full-text search capabilities across codebases
  • Intelligent recommendations based on codebase size
  • Condensed project overviews for better understanding
  • High-concurrency support with advanced database resilience

Usages

usage with poetry

# Install with Poetry
poetry add mcp-code-indexer

usage with pip

# Or with pip
pip install mcp-code-indexer

usage with http server

# Start HTTP server with authentication
mcp-code-indexer --http --auth-token "your-secret-token"

# Custom host and port
mcp-code-indexer --http --host 0.0.0.0 --port 8080

# CORS configuration for web apps
mcp-code-indexer --http --cors-origins "https://localhost:3000" "https://myapp.com"

usage with openrouter

# Set OpenRouter API key for Claude access
export OPENROUTER_API_KEY="your-openrouter-api-key"

# Simple questions about project architecture
mcp-code-indexer --ask "What does this project do?" my-project

# Enhanced analysis with file search
mcp-code-indexer --deepask "How is authentication implemented?" web-app

# JSON output for programmatic use
mcp-code-indexer --ask "List the main components" my-project --json

usage with git hook

# Set your OpenRouter API key
export OPENROUTER_API_KEY="sk-or-v1-your-api-key-here"

# Test git hook functionality
mcp-code-indexer --githook

# Install post-commit hook
cp examples/git-hooks/post-commit .git/hooks/
chmod +x .git/hooks/post-commit

Tools

  1. check_codebase_size

    Get navigation recommendations for any project.

  2. search_descriptions

    Find files by functionality.

  3. get_codebase_overview

    Provides a project architectural summary.

  4. get_file_description

    Retrieve file summaries for quick understanding.

  5. update_file_description

    Store detailed file analysis.