Repolode
제출하기
Jakedismo

Jakedismo/codegraph-rust

코드베이스의 시맨틱 지식 그래프를 구축하고 MCP를 통해 코딩 에이전트에 에이전트 기반 코드 분석 도구를 제공하는 Rust 도구입니다.

GitHub에서 보기
스타
913
포크
98
열린 이슈
17
마지막 커밋
25일 전

어떤 프로젝트인가요?

CodeGraph는 AST 파싱, 선택적 언어 서버 심볼 해석, 모듈 연결, 임베딩을 결합해 프로젝트를 노드와 엣지로 구성된 지식 그래프로 인덱싱합니다. 그래프는 각 프로젝트의 .codegraph 디렉터리에 있는 임베디드 SurrealDB 데이터베이스에 저장되므로 별도의 데이터베이스 서버가 필요하지 않습니다.

Claude Code, Cursor, Codex 같은 AI 코딩 어시스턴트를 위해 설계됐습니다. 통합된 에이전트 기반 도구 4개(context, impact, architecture, quality)는 그래프를 대상으로 추론 에이전트를 실행하고, 원시 검색 결과 목록 대신 파일 경로, 줄 번호, 길이가 제한된 코드 조각을 포함한 답변을 반환합니다. 인덱싱은 fast, balanced, full의 세 단계로 진행되어 그래프의 풍부함과 속도 및 저장 공간 사이에서 선택할 수 있습니다.

검색에는 벡터 유사도와 어휘 매칭이 사용되며, 선택적으로 재순위화를 적용할 수 있습니다. 또한 실행마다 모델에 전달되는 도구 출력의 양을 제한하고, Ollama, LM Studio, Jina, OpenAI, Anthropic 등 여러 임베딩 및 LLM 제공자를 지원합니다.

핵심 기능

  • 01코드 노드, 엣지, 모듈, 데이터 흐름 관계로 구성된 지식 그래프를 구축합니다.
  • 02컨텍스트, 변경 영향, 아키텍처, 품질 분석을 위한 에이전트 기반 MCP 도구 4개를 제공합니다.
  • 03선택적 LSP 해석과 함께 fast, balanced, full 인덱싱 단계를 지원합니다.
  • 04프로젝트별 임베디드 SurrealDB에 데이터를 저장하므로 별도 서버가 필요하지 않습니다.
  • 05벡터 검색과 어휘 검색을 결합하며, 선택적으로 재순위화를 적용할 수 있습니다.
  • 06인덱싱 시 .gitignore를 따르고 일반적인 비밀 정보 파일 패턴을 제외합니다.

활용 사례

  • 대규모 코드베이스를 리팩터링하기 전에 Claude Code나 Cursor에 프로젝트 전반의 컨텍스트를 제공하는 경우.
  • 함수, 타입, 모듈을 변경했을 때 어떤 부분이 영향을 받는지 파악하는 경우.
  • 익숙하지 않은 Rust 프로젝트의 아키텍처를 개괄하거나 복잡도가 높은 지점을 찾는 경우.
  • 소스 코드를 로컬에 유지하면서 로컬 또는 자체 호스팅 임베딩 모델을 실행하는 경우.

빠른 시작

  1. 1

    Installation Guide(docs/INSTALLATION_GUIDE.md)에 따라 CodeGraph를 설치합니다

  2. 2

    balanced tier로 프로젝트를 인덱싱합니다

    codegraph index /path/to/project --index-tier balanced
  3. 3

    명령줄에서 질문합니다

    codegraph agent context "your question"

사용 전 알아둘 점

  • balanced 및 full 인덱싱 tier를 사용하려면 rust-analyzer, node, gopls와 같은 외부 언어 서버를 설치해야 합니다.
  • 인덱싱에는 다양한 구성 옵션과 환경 변수가 있어 설정에 어느 정도 노력이 필요합니다.

포함된 컬렉션

오픈소스 AI 에이전트 프레임워크와 앱AI 코딩 어시스턴트와 에이전트MCP 서버

토픽

#code-search#rag#graphrag#mcp#rust#semantic-search#code-analysis#coding-agent#agents#ai-agents

자주 묻는 질문

codegraph-rust은(는) 무엇인가요?
코드베이스의 시맨틱 지식 그래프를 구축하고 MCP를 통해 코딩 에이전트에 에이전트 기반 코드 분석 도구를 제공하는 Rust 도구입니다. CodeGraph는 AST 파싱, 선택적 언어 서버 심볼 해석, 모듈 연결, 임베딩을 결합해 프로젝트를 노드와 엣지로 구성된 지식 그래프로 인덱싱합니다. 그래프는 각 프로젝트의 .codegraph 디렉터리에 있는 임베디드 SurrealDB 데이터베이스에 저장되므로 별도의 데이터베이스 서버가 필요하지 않습니다.
codegraph-rust은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
codegraph-rust에는 명시된 라이선스가 없습니다. 코드는 공개되어 있지만 라이선스가 없으면 재사용 허가가 명확하지 않으므로, 사용 전에 작성자에게 문의하는 것이 좋습니다.
codegraph-rust은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. codegraph-rust의 마지막 커밋은 2026년 10월 12일입니다.
codegraph-rust은(는) 어디에 사용할 수 있나요?
대규모 코드베이스를 리팩터링하기 전에 Claude Code나 Cursor에 프로젝트 전반의 컨텍스트를 제공하는 경우. 함수, 타입, 모듈을 변경했을 때 어떤 부분이 영향을 받는지 파악하는 경우. 익숙하지 않은 Rust 프로젝트의 아키텍처를 개괄하거나 복잡도가 높은 지점을 찾는 경우. 소스 코드를 로컬에 유지하면서 로컬 또는 자체 호스팅 임베딩 모델을 실행하는 경우.
codegraph-rust는 어떻게 설치하나요?
Installation Guide(docs/INSTALLATION_GUIDE.md)에 따라 CodeGraph를 설치합니다 balanced tier로 프로젝트를 인덱싱합니다: codegraph index /path/to/project --index-tier balanced 명령줄에서 질문합니다: codegraph agent context "your question"
codegraph-rust은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/Jakedismo/codegraph-rust

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트