MCP와 CLI로 AI 코딩 도구에 정확한 리뷰 맥락을 제공하는 로컬 코드 지식 그래프입니다.
Done-0/fuck-u-code
14개 언어의 프로젝트 코드 품질을 평가하고 전체 점수와 파일별 순위를 보고하는 CLI입니다.
- 스타
- 7,306
- 포크
- 328
- 열린 이슈
- 26
- 마지막 커밋
- 지난달
어떤 프로젝트인가요?
fuck-u-code는 코드베이스에 얼마나 많은 "레거시 난장판"이 있는지 추정하는 명령줄 도구입니다. 복잡도, 크기, 주석, 오류 처리, 명명, 중복, 구조를 아우르는 7가지 항목을 검사한 뒤, 전체 점수(0~100)와 파일별 점수를 산출합니다. 파일별 점수는 높을수록 상태가 좋지 않다는 뜻입니다.
구문 분석에는 tree-sitter를 사용하며 Go, JavaScript, TypeScript, Python, Java, C, C++, Rust, C#, Lua, PHP, Ruby, Swift, Shell을 지원합니다. 결과는 색상이 적용된 터미널 출력, Markdown, JSON 또는 HTML로 확인할 수 있고, 인터페이스는 영어, 중국어, 러시아어로 제공됩니다. 설정은 `.fuckucoderc.json` 또는 지원되는 다른 형식의 파일에서 읽으며, `.gitignore` 규칙도 적용됩니다.
선택적으로 AI 리뷰 기능을 사용하면 점수가 가장 낮은 파일을 OpenAI 호환 모델, Anthropic, DeepSeek, Gemini 또는 Ollama 모델에 전송할 수 있습니다. 핵심 분석은 오프라인에서 실행됩니다. 또한 Claude Code, Cursor 같은 도구가 분석을 직접 호출할 수 있도록 MCP 서버도 제공합니다.
핵심 기능
- 017가지 품질 기준으로 코드를 평가하고 0~100점의 전체 점수를 산출합니다.
- 02파일별 "shit-gas" 지수로 순위를 매겨 가장 문제가 큰 파일을 찾아냅니다.
- 03tree-sitter로 14개 언어를 구문 분석합니다.
- 04콘솔, Markdown, JSON 또는 HTML 보고서를 출력합니다.
- 05핵심 분석은 오프라인에서 실행되며, 여러 제공자를 통한 AI 리뷰를 선택적으로 사용할 수 있습니다.
- 06AI 코딩 도구를 위한 MCP 서버를 제공합니다.
활용 사례
- 리팩터링 전에 레거시 코드베이스의 품질을 빠르게 파악할 때.
- 정리 작업의 우선순위를 정하기 위해 복잡하거나 중복된 파일을 찾을 때.
- JSON 또는 Markdown 출력으로 코드 리뷰나 CI 워크플로에 품질 보고서를 추가할 때.
- MCP를 통해 AI 코딩 어시스턴트가 코드 품질을 검사하도록 할 때.
빠른 시작
- 1
npm에서 CLI를 전역으로 설치합니다
npm install -g eff-u-code - 2
현재 디렉터리를 분석합니다
fuck-u-code analyze
사용 전 알아둘 점
- AI 코드 리뷰를 사용하려면 외부 API 키 또는 로컬 Ollama 인스턴스가 필요합니다.
- npm 패키지 이름은 eff-u-code이고, 명령어는 fuck-u-code입니다.
토픽
자주 묻는 질문
- fuck-u-code은(는) 무엇인가요?
- 14개 언어의 프로젝트 코드 품질을 평가하고 전체 점수와 파일별 순위를 보고하는 CLI입니다. fuck-u-code는 코드베이스에 얼마나 많은 "레거시 난장판"이 있는지 추정하는 명령줄 도구입니다. 복잡도, 크기, 주석, 오류 처리, 명명, 중복, 구조를 아우르는 7가지 항목을 검사한 뒤, 전체 점수(0~100)와 파일별 점수를 산출합니다. 파일별 점수는 높을수록 상태가 좋지 않다는 뜻입니다.
- fuck-u-code은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
- fuck-u-code은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
- fuck-u-code은(는) 아직 유지보수되고 있나요?
- 6개월 이내 업데이트. fuck-u-code의 마지막 커밋은 2026년 9월 7일입니다.
- fuck-u-code은(는) 어디에 사용할 수 있나요?
- 리팩터링 전에 레거시 코드베이스의 품질을 빠르게 파악할 때. 정리 작업의 우선순위를 정하기 위해 복잡하거나 중복된 파일을 찾을 때. JSON 또는 Markdown 출력으로 코드 리뷰나 CI 워크플로에 품질 보고서를 추가할 때. MCP를 통해 AI 코딩 어시스턴트가 코드 품질을 검사하도록 할 때.
- fuck-u-code는 어떻게 설치하나요?
- npm에서 CLI를 전역으로 설치합니다: npm install -g eff-u-code 현재 디렉터리를 분석합니다: fuck-u-code analyze
- fuck-u-code은(는) 어디서 받을 수 있나요?
- 소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/Done-0/fuck-u-code
요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.
관련 프로젝트
AI 프롬프트로 복사할 수 있는 댓글을 지원하는 로컬 GitHub 스타일 diff 리뷰 CLI 도구
Claude나 ChatGPT 같은 LLM에 전달할 수 있도록 전체 코드 저장소를 하나의 AI 친화적인 파일로 묶는 CLI 및 웹 도구입니다.
Rust로 작성된 초고속 Python 린터이자 코드 포매터로, 900개 이상의 린트 규칙과 Black 호환 포매팅을 제공합니다.
웹 기술로 만든 크로스 플랫폼 터미널 에뮬레이터로, 플러그인과 테마를 추가해 확장할 수 있습니다.
JavaScript와 TypeScript를 위한 무설정 린터 및 포매터로, 명령 하나로 Biome, ESLint 또는 Oxlint에 프리셋 규칙을 적용합니다.