Repolode
제출하기
Mibayy

Mibayy/token-savior

AI 코딩 에이전트를 위한 MCP 서버로, 심볼 기반 코드 인덱싱과 지속형 메모리, Bash 명령 재작성을 통해 토큰 사용량을 줄입니다.

GitHub에서 보기웹사이트
스타
1,209
포크
110
열린 이슈
9
마지막 커밋
23일 전

어떤 프로젝트인가요?

Token Savior는 Claude Code 같은 AI 코딩 에이전트와 코드베이스 사이에서 동작하는 MCP 서버입니다. 모델이 간단한 질문에 답하려고 파일 전체를 읽는 대신, 프로젝트를 심볼(함수, 클래스, import 및 호출 그래프) 단위로 인덱싱합니다. 따라서 에이전트는 파일 전체를 읽지 않고 포인터를 통해 정의나 해당 요소에 의존하는 항목을 찾을 수 있습니다.

또한 결정 사항, 버그 수정 내용, 규칙, 세션 요약을 SQLite에 저장하는 지속형 메모리 엔진을 포함합니다. 전문 검색과 선택적 벡터 검색을 지원하며, 다음 세션이 시작될 때 간결한 요약을 다시 주입합니다. PreToolUse Bash rewriter는 명령 실행 전에 내용을 수정해 출력을 줄이고, PostToolUse compactor는 git, pytest, kubectl, aws 같은 일반적인 도구의 출력을 압축해 보여줍니다.

서버는 단일 도구부터 68개 도구까지 다양한 도구 프로필을 제공하며, `ts init` 명령으로 Claude Code, Cursor, Gemini, Codex, OpenClaw에 훅을 설정합니다. MCP를 지원하지 않는 에이전트에서 사용할 수 있는 CLI(`ts`)도 제공됩니다.

핵심 기능

  • 01find_symbol 및 호출 그래프에서 해당 심볼에 의존하는 항목 찾기를 포함한 심볼 단위 코드 탐색
  • 02전문 검색과 선택적 벡터 검색을 지원하는 SQLite 기반 지속형 메모리
  • 03모델에 전달되기 전에 명령 출력을 줄이는 PreToolUse Bash rewriter
  • 04git, 테스트 러너, 클라우드 CLI, Docker용 PostToolUse compactor 34개
  • 05설정 가능한 도구 프로필과 Claude Code, Cursor, Gemini, Codex, OpenClaw용 `ts init` 명령

활용 사례

  • 에이전트가 작은 코드 조각을 찾으려고 파일 전체를 계속 다시 읽는 대규모 코드베이스 작업
  • 여러 Claude Code 세션에서 아키텍처 결정 사항과 버그 수정 메모를 계속 사용할 수 있도록 관리
  • 반복적인 코드 탐색과 테스트 실행을 수행하는 에이전트의 토큰 비용과 지연 시간 절감
  • Cursor 같은 비-MCP 도구나 스크립트에서 ts CLI를 통해 심볼 검색을 위한 셸 접근 제공

빠른 시작

  1. 1

    MCP 지원을 포함해 PyPI에서 패키지를 설치합니다

    pip install "token-savior-recall[mcp]"
  2. 2

    워크스페이스 루트와 프로필을 지정해 MCP 설정(예: Claude Code)에 서버를 추가합니다

사용 전 알아둘 점

  • 주요 벤치마크 수치는 작성자가 보고한 것이며 하네스 저장소도 공개되지 않아 독립적으로 검증할 수 없습니다.
  • Claude Code 사용자는 alwaysLoad를 true로 설정해야 합니다. 그렇지 않으면 도구가 ToolSearch 뒤에 숨겨져 거의 사용되지 않습니다.
  • PostToolUse Bash 압축기는 현재 턴의 토큰 수를 줄이지 않습니다. 토큰 수를 줄이는 것은 PreToolUse 재작성기뿐입니다.

포함된 컬렉션

Claude Code용 MCP 서버Claude Code 도구·스킬·플러그인오픈소스 AI 에이전트 프레임워크와 앱MCP 서버

토픽

#mcp#claude-code#ai-agent#code-navigation#token-optimization#persistent-memory#python#developer-tools

자주 묻는 질문

token-savior은(는) 무엇인가요?
AI 코딩 에이전트를 위한 MCP 서버로, 심볼 기반 코드 인덱싱과 지속형 메모리, Bash 명령 재작성을 통해 토큰 사용량을 줄입니다. Token Savior는 Claude Code 같은 AI 코딩 에이전트와 코드베이스 사이에서 동작하는 MCP 서버입니다. 모델이 간단한 질문에 답하려고 파일 전체를 읽는 대신, 프로젝트를 심볼(함수, 클래스, import 및 호출 그래프) 단위로 인덱싱합니다. 따라서 에이전트는 파일 전체를 읽지 않고 포인터를 통해 정의나 해당 요소에 의존하는 항목을 찾을 수 있습니다.
token-savior은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
token-savior은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
token-savior은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. token-savior의 마지막 커밋은 2026년 10월 15일입니다.
token-savior은(는) 어디에 사용할 수 있나요?
에이전트가 작은 코드 조각을 찾으려고 파일 전체를 계속 다시 읽는 대규모 코드베이스 작업 여러 Claude Code 세션에서 아키텍처 결정 사항과 버그 수정 메모를 계속 사용할 수 있도록 관리 반복적인 코드 탐색과 테스트 실행을 수행하는 에이전트의 토큰 비용과 지연 시간 절감 Cursor 같은 비-MCP 도구나 스크립트에서 ts CLI를 통해 심볼 검색을 위한 셸 접근 제공
token-savior는 어떻게 설치하나요?
MCP 지원을 포함해 PyPI에서 패키지를 설치합니다: pip install "token-savior-recall[mcp]" 워크스페이스 루트와 프로필을 지정해 MCP 설정(예: Claude Code)에 서버를 추가합니다
token-savior은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/Mibayy/token-savior

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

관련 프로젝트