Argyph: 19개의 구조화된 코드 이해 도구를 갖춘 Claude Code용 단일 MCP 서버

실제 코드베이스에서 Claude Code를 사용해 본 적이 있다면, 에이전트가 맹목적으로 grep을 실행하거나 전체 파일을 컨텍스트로 가져오는 한계에 부딪힌 적이 있을 것입니다. Argyph는 리포지토리를 인덱싱하고 에이전트에게 19개의 도구를 제공하는 단일 MCP 서버로, 전체 파일을 덤프하는 대신 제한된 범위를 반환합니다. API 키 없이 사용자 머신에서 완전히 실행됩니다.

설정

한 줄로 추가할 수 있습니다:

claude mcp add argyph -- npx argyph@latest

그런 다음 리포지토리에서:

argyph init

기능

• 구조적 쿼리: find_definition, find_references, get_callers, get_callees, 호출 그래프 등 — 전체 파일이 아닌 특정 범위를 반환합니다.
• 의미 검색: 내장 벡터 저장소와 번들된 로컬 임베딩 모델을 포함합니다. 의미 검색은 첫 실행 시 백그라운드에서 구축됩니다.
• 토큰 예산 기반 리포지토리 패킹: 토큰 예산 내에서 에이전트에게 관련 컨텍스트를 패킹합니다.
• 읽기 전용: 코드를 편집, 커밋 또는 실행하지 않습니다.
• 속도: 이전에 인덱싱된 리포지토리에서 1초 이내에 준비됩니다. 첫 실행: 구조적 쿼리는 몇 초 이내, 의미 검색은 비동기적으로 구축됩니다.
• 피드백: 도구는 index_coverage 필드를 반환하여 에이전트가 무엇을 사용할 수 있는지 알 수 있게 합니다.

중요성

Argyph는 사람들이 일반적으로 연결하는 여러 개별 MCP 서버(grep, 임베딩, 심볼 검색, repomix)를 하나로 대체합니다. 전체 기능을 위해 외부 API 키가 필요 없으며, 어떤 데이터도 노트북 밖으로 나가지 않습니다. 내장 벡터 저장소와 로컬 임베딩 모델이 포함되어 있습니다.

대규모 실제 코드베이스에서 Claude Code를 실행하는 개발자에게, 이는 컨텍스트 창을 날려버리지 않으면서 에이전트에게 빠르고 구조화된 의미적 컨텍스트를 제공하는 실용적인 방법입니다.

GitHub: https://github.com/Ezzy1630/argyph