Skip to main content
Glama

코드베이스 MCP

RepoMix를 사용하여 전체 코드베이스를 검색하고 분석하는 도구를 제공하는 MCP(Model Context Protocol) 서버 구현입니다.

이 MCP를 사용하면 Cursor의 Composer Agent와 같은 AI 에이전트가 전체 코드베이스를 한 번에 자동으로 읽고 이해할 수 있으므로 개발자는 대규모 코드베이스로 작업하기가 더 쉬워지고 AI 어시스턴트는 프로젝트에 대한 포괄적인 맥락을 파악하기가 더 쉬워집니다.

특징

  • 📚 코드베이스 검색 : 전체 코드베이스를 다양한 형식(XML, 마크다운, 일반)의 단일 텍스트 출력으로 검색합니다.

  • 🌐 원격 저장소 지원 : 원격 GitHub 저장소를 직접 처리합니다.

  • 💾 파일 저장 : 처리된 코드베이스를 파일에 저장합니다.

  • 🔧 사용자 정의 옵션 : 다양한 옵션(주석, 줄 번호, 파일 요약 등)을 사용하여 코드베이스가 처리되는 방식을 제어합니다.

Related MCP server: CodeAlive MCP

설치

NPM에서 (추천)

지엑스피1

GitHub에서

# Clone the repository
git clone https://github.com/DeDeveloper23/codebase-mcp.git

# Navigate to the project directory
cd codebase-mcp

# Install dependencies
npm install

# Build the project
npm run build

# Install globally
npm install -g .

# Install RepoMix (required dependency)
codebase-mcp install

커서와의 통합

이 MCP를 Cursor의 Composer Agent와 함께 사용하려면:

  1. 커서 IDE 열기

  2. 사이드바에서 Composer 아이콘을 클릭하세요

  3. 상단의 "MCP 서버" 버튼을 클릭하세요

  4. "새 MCP 서버 추가"를 클릭하세요.

  5. 자세한 내용을 입력하세요:

    • 이름: Codebase MCP (또는 원하는 이름)

    • 유형: command

    • 명령어: codebase-mcp start

  6. "추가"를 클릭하여 저장하세요

MCP를 추가하면 Composer Agent에 세 가지 강력한 도구가 제공됩니다.

사용 가능한 도구

  1. getCodebase

    • 목적: 현재 작업 공간/프로젝트 분석

    • 사용 시기: AI가 전체 코드베이스를 이해하도록 하려는 경우

    • 예시 프롬프트: "코드베이스의 구조를 이해하려면 코드베이스를 분석하세요"

  2. getRemoteCodebase

    • 목적: 모든 공개 GitHub 저장소를 가져와 분석합니다.

    • 사용 시기: 다른 프로젝트를 탐색하거나 이해하고 싶을 때

    • 예시 프롬프트: "github.com/username/repo의 저장소를 분석할 수 있나요?"

  3. 코드베이스 저장

    • 목적: 나중에 사용할 수 있도록 코드베이스 분석을 파일에 저장합니다.

    • 사용 시기: 코드베이스 스냅샷을 보존하거나 공유하려는 경우

    • 예시 프롬프트: "나중에 검토하기 위해 이 코드베이스에 대한 분석을 저장하세요"

커서에서의 사용 예

다음은 Composer Agent와 함께 사용할 수 있는 몇 가지 프롬프트 예시입니다.

"Analyze my current project and explain its main components."

"Can you look at the tensorflow/tensorflow repository and explain how their testing framework works?"

"Save an analysis of my project to 'codebase-analysis.md' in markdown format."

Composer Agent는 귀하의 요청에 따라 자동으로 적절한 도구를 사용합니다.

커서 외부 사용

MCP 서버 시작

codebase-mcp start

이렇게 하면 MCP 서버가 stdio 모드로 시작되며, 모든 MCP 호환 클라이언트에서 사용할 수 있습니다.

특허

MIT

Available Tools

3 tools
getCodebaseC

Retrieve the entire codebase as a single text output using RepoMix

Inputs: cwd, format, ignorePatterns, includeDirectoryStructure, +5 more.

getRemoteCodebaseC

Retrieve a remote repository's codebase as a single text output using RepoMix

Inputs: repo (required), format, ignorePatterns, includeDirectoryStructure, +5 more.

saveCodebaseC

Save the codebase to a file using RepoMix

Inputs: cwd, format, ignorePatterns, includeDirectoryStructure, +6 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.1/5.0

    Scored across 3 tools

    Disambiguation4/5

    The three tools have distinct purposes: retrieving local codebase, retrieving remote codebase, and saving codebase. While 'getCodebase' and 'getRemoteCodebase' both retrieve code, the local/remote distinction is clear. There's minor potential confusion about whether 'saveCodebase' saves the local or remote version, but overall boundaries are well-defined.

    Naming Consistency5/5

    All tools follow a consistent verb_noun pattern with camelCase styling: getCodebase, getRemoteCodebase, saveCodebase. The naming is predictable and follows the same grammatical structure throughout, making it easy for agents to understand the action-object relationship.

    Tool Count3/5

    With only 3 tools, this feels quite minimal for a 'Codebase MCP' server. While the tools cover basic retrieval and saving operations, the scope seems limited - there are no tools for searching, analyzing, modifying, or managing codebase components. The count is borderline thin for what could be expected from a codebase management system.

    Completeness2/5

    For a codebase management server, there are significant gaps in functionality. The tools only provide retrieval and saving operations using RepoMix, but lack any tools for code analysis, search, modification, version control operations, or component management. This creates a dead-end surface where agents can only get and save entire codebases without any ability to work with code meaningfully.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      A Model Context Protocol server that enhances AI agents by providing deep semantic understanding of codebases, enabling more intelligent interactions through advanced code search and contextual awareness.
      91
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      An enterprise-grade Model Context Protocol server that provides comprehensive GitHub repository analysis and AI-powered development assistance through 11 streamlined tools.
      11
      2
      MIT
    • A
      license
      B
      quality
      D
      maintenance
      A Model Context Protocol (MCP) server that enables AI applications to access and analyze local code repositories without manual uploads, providing file listing, content reading, code searching, and project structure analysis capabilities.
      7
      MIT