JC

johnhuang316/code-index-mcp

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

1천 stars 119 forks 품질 76 트렌드 27MIT

대규모 언어 모델이 최소한의 설정으로 코드 저장소를 색인화, 검색, 분석할 수 있도록 돕는 모델 컨텍스트 프로토콜(MCP) 서버입니다

개요

AI가 코드베이스를 이해하는 방식을 고급 검색, 분석, 내비게이션 기능으로 혁신하세요. Code Index MCP는 AI 모델과 복잡한 코드베이스 간의 간극을 메우는 모델 컨텍스트 프로토콜 서버입니다. 지능형 인덱싱, 고급 검색 기능, 상세한 코드 분석을 제공하여 AI 보조가 프로젝트를 효과적으로 이해하고 탐색할 수 있도록 돕습니다. 코드 리뷰, 리팩토링, 문서 생성, 디버깅 지원, 아키텍처 분석. MCP 호환 애플리케이션을 시작하는 가장 쉬운 방법: 1. (예: claude_desktop_config.json 또는 ~/.claude.json): 선택 사항: args 배열에 --project-path /absolute/path/to/repo를 추가하여 서버가 해당 저장소를 자동으로 초기화하도록 합니다(시작 후 set_project_path 호출과 동일). 2. – UVX는 자동으로 설치 및 실행을 처리합니다 3.

개요(AI 번역)

대형 언어 모델을 위한 지능형 코드 인덱싱 및 분석

AI가 코드베이스를 이해하는 방식을 고급 검색, 분석, 내비게이션 기능으로 혁신하세요.

개요

Code Index MCP는 AI 모델과 복잡한 코드베이스 간의 간극을 메우는 모델 컨텍스트 프로토콜 서버입니다. 지능형 인덱싱, 고급 검색 기능, 상세한 코드 분석을 제공하여 AI 보조가 프로젝트를 효과적으로 이해하고 탐색할 수 있도록 돕습니다.

**완벽함: ** 코드 리뷰, 리팩토링, 문서 생성, 디버깅 지원, 아키텍처 분석.

퀵 스타트

🚀 권장 설정 (대부분 사용자)

MCP 호환 애플리케이션을 시작하는 가장 쉬운 방법:

전제 조건: Python 3.10+ 및 uv

  1. MCP 구성에 추가하세요 (예: claude_desktop_config.json 또는 ~/.claude.json):

선택 사항: args 배열에 --project-path /absolute/path/to/repo를 추가하여 서버에 해당 저장소에서 자동으로 초기화됩니다([[T4]를 호출하는 것과 동일합니다). 시작 후)

  1. 애플리케이션 재시작 – uvx가 자동으로 설치 및 실행을 처리합니다

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.

README

원문 README의 일부입니다. 원문 보기.

Code Index MCP

Overview

Code Index MCP is a Model Context Protocol server that bridges the gap between AI models and complex codebases. It provides intelligent indexing, advanced search capabilities, and detailed code analysis to help AI assistants understand and navigate your projects effectively.

Perfect for: Code review, refactoring, documentation generation, debugging assistance, and architectural analysis.

Quick Start

🚀 Recommended Setup (Most Users)

The easiest way to get started with any MCP-compatible application:

Prerequisites: Python 3.10+ and uv

  1. Add to your MCP configuration (e.g., claude_desktop_config.json or ~/.claude.json):

    {
      "mcpServers": {
        "code-index": {
          "command": "uvx",
          "args": ["code-index-mcp"]
        }
      }
    }
    

    Optional: append --project-path /absolute/path/to/repo to the args array so the server initializes with that repository automatically (equivalent to calling set_project_path after startup).

  2. Restart your application – uvx automatically handles installation and execution

  3. Start using (give these prompts to your AI assistant):

    Set the project path to /Users/dev/my-react-app
    Find all TypeScript files in this project  
    Search for "authentication" functions
    Analyze the main App.tsx file
    

    If you launch with --project-path, you can skip the first command above - the server already knows the project location.

Codex CLI Configuration

If you are using Anthropic’s Codex CLI, add the server to ~/.codex/config.toml. On Windows the file lives at C:\Users\\.codex\config.toml:

[mcp_servers.code-index]
type = "stdio"
command = "uvx"
args = ["code-index-mcp"]

You can append --project-path C:/absolute/path/to/repo to the args list to set the project automatically on startup (same effect as running the set_project_path tool).

On Windows, uvx needs the standard profile directories to be present. Keep the environment override in the same block so the MCP starts reliably:

env = {
GitHub에서 전체 README 보기

설치

uvx code-index-mcp
MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

{ "mcpServers": { "code-index": { "command": "uvx", "args": ["code-index-mcp"] } } }