이 MCP 서버는 macOS 및 Linux에서 테스트되었습니다. Windows 지원은 현재 인증되지 않습니다 ( 아직 테스트되지 않음).

Windows를 시도하고 문제가 발생하면 문제를 열어서 cross-platform 지원을 향상시킬 수 있습니다.

코드 MCP Server 이해

MCP (Model Context Protocol) 서버는 codebase를 이해하고 AI 코딩 조수에 지능적인 컨텍스트를 제공합니다. 이 서버는 로컬 및 원격 GitHub 저장소를 모두 처리하고 표준 MCP-compliant 작업을 지원합니다.

. AI Assistant 설치

** AI 코딩 조수가이 서버를 설치하는 데 도움이됩니다! ** Setup Assistant Prompt의 내용을 AI Assistant(Claude, ChatGPT, Cursor, etc.)로 복사하여 전체 설치 과정을 안내합니다.

특징

• Clone 및 GitHub 저장소 또는 로컬 codebase 분석
• 저장소 구조 및 파일 조직 가져 오기
• 복잡도 측정 및 코드 구조에 근거한 중요한 파일 식별
• 상세한 저장소 맵을 생성:
• 기능 서명 및 관계
• 클래스 정의 및 계층
• 코드 구조 및 의존성
• 저장소 문서 검색 및 분석

⚠️ Platform Support Notice

This MCP server has been tested on macOS and Linux. Windows support is currently unverified (not yet tested).

If you try Windows and encounter issues, please open an issue so we can improve cross-platform support.

Code Understanding MCP Server

An MCP (Model Context Protocol) server designed to understand codebases and provide intelligent context to AI coding assistants. This server handles both local and remote GitHub repositories and supports standard MCP-compliant operations.

🤖 AI Assistant Installation

Have an AI coding assistant help you install this server! Copy and paste the contents of our Setup Assistant Prompt to your AI assistant (Claude, ChatGPT, Cursor, etc.) and it will guide you through the entire installation process.

Features

• Clone and analyze GitHub repositories or local codebases
• Get repository structure and file organization
• Identify critical files based on complexity metrics and code structure
• Generate detailed repository maps showing:
  • Function signatures and relationships
  • Class definitions and hierarchies
  • Code structure and dependencies
• Retrieve and analyze repository documentation
• Target analysis to specific files or directories
• Keep analysis up-to-date with repository changes via refresh

Quick Start: MCP Client Configuration

Prerequisites

Required: uv Installation

This server requires uv, a modern Python package manager. If you don’t already have uv installed:

# Install UV (macOS/Linux)
curl -sSf https://astral.sh/uv/install.sh | sh

# Install UV (Windows PowerShell)
irm https://astral.sh/uv/install.ps1 | iex

For more installation options, visit the official uv installation guide at astral.sh/uv.

Installation Methods

Method 1: Direct execution with uvx (Recommended)

# Run directly without installing a global binary
uvx code-understanding-mcp-server

This launches the server in an isolated environment managed by UV each time.

Method 2: Virtual environment install (Optional)

If you prefer a persistent binary inside a dedicated virtual environment:

# Create a dedicated virtual environment
uv venv ~/.venvs/mcp-code-understanding

# Activate it (macOS/Linux)
source ~/.venvs/mcp-code-understanding/bin/activate

# Install the package into the venv
uv pip install code-understanding-mcp-server

# Run the server
code-understanding-mcp-server

Verify Installation

Depending on your chosen method:

# Method 1 (uvx): runs via uvx; no persistent binary is installed
uvx --version

# Method 2 (venv install): verify the binary inside your venv
which code-understanding-mcp-server
# Expected output example: /Users/username/.venvs/mcp-code-understanding/bin/code-understanding-mcp-server

Configure Your MCP Client

Use one of the following configurations for your MCP client:

{
  "mcpServers": {