Moth

Moth는 프로젝트 로컬 버그 수정 분석 및 검증된 수정 사항 메모리를 위한 경량 MCP 서버입니다.

Moth의 기능

Moth는 MCP를 통해 오류 출력을 수신하고, 잠재적인 비밀 정보를 마스킹하며, 실패를 정규화하고, 가능성 있는 스택을 감지하며, 프로젝트 로컬 수정 메모리를 확인한 후 구조화된 수정 요약본을 반환합니다.

Moth는 코드를 편집하거나, 셸 명령을 실행하거나, 저장소를 크롤링하거나, 백엔드를 요구하거나, 전역 버그 데이터베이스를 유지하지 않습니다.

왜 Moth인가?

버그 수정 컨텍스트는 종종 프로젝트에 국한됩니다: 실패한 명령, 사용 중인 프레임워크, 주변 구성, 그리고 해당 저장소에서 이미 작동했거나 실패했던 수정 사항 등이 그것입니다.

Moth는 이러한 워크플로우를 작고 명확하게 유지합니다. 제공된 오류 컨텍스트를 분석하고, 가장 좋은 첫 번째 수정 사항을 제안하며, 검증된 수정 결과만을 프로젝트 로컬 메모리에 기록합니다.

빠른 시작

Node.js 18+ 버전이 필요합니다.

직접 실행:

npx -y @stfade/moth moth-mcp

또는 전역 설치:

npm install -g @stfade/moth
moth-mcp

일반적인 MCP 설정

{
  "mcpServers": {
    "moth": {
      "command": "npx",
      "args": ["-y", "@stfade/moth", "moth-mcp"]
    }
  }
}

사용 예시

Moth를 지원되는 AI 에이전트와 함께 사용할 때, 오류와 함께 다음과 같은 간단한 프롬프트를 포함할 수 있습니다:

"Use Moth to analyze this error before fixing it."

지원되는 클라이언트

“로컬 플러그인 준비 완료”는 통합 래퍼가 포함되어 있어 로컬에서 테스트할 수 있음을 의미합니다. 마켓플레이스 제출 및 승인은 아직 포함되지 않았습니다.

도구

Moth는 정확히 두 개의 MCP 도구를 노출합니다.

analyze_error

수정을 시도하기 전에 제공된 오류 출력을 분석합니다.

입력 필드:

• error_output

• command?

• cwd?

• package_context?

• relevant_files?

• environment?

출력 필드:

• analysis_id

• fingerprint

• stack

• likely_cause

• best_first_fix

• verification

• prior_project_fixes

• avoid

• confidence

remember_fix_result

검증된 프로젝트 로컬 수정 메모리를 기록합니다.

입력 필드:

• analysis_id

• fingerprint

• stack

• fix_attempted

• verification_command

• verification_result: "passed" | "failed"

• notes?

공개 worked 입력은 거부됩니다. worked는 verification_result에서 파생됩니다.

검증된 메모리 수명 주기

analyze_error
→ apply/attempt fix
→ run verification command
→ remember_fix_result

다음 경우에만 remember_fix_result를 호출하십시오:

1. 수정/변경이 실제로 시도된 경우

2. 검증 명령이 실제로 실행된 경우

3. 결과가 명확하게 passed 또는 failed인 경우

제안, 건너뛴 변경, 누락된 검증, 모호한 결과 또는 추측에 대해서는 호출하지 마십시오.

로컬 메모리

검증된 프로젝트 로컬 수정 메모리는 다음 위치에 저장됩니다:

.moth/fix-memory.jsonl

Moth는 MCP 서버 재시작 후 remember_fix_result가 올바른 프로젝트 경로를 매핑할 수 있도록 프로젝트 외부에 작은 Moth 전용 분석 레지스트리를 유지합니다.

스킬

Moth는 호환되는 에이전트를 위한 간결한 스킬을 포함합니다:

• moth-debug-first-fix

• moth-source-backed-research

• moth-verify-fix

MCP 서버 자체는 실시간 웹 조사를 수행하지 않습니다. 호환되는 에이전트는 외부 소스가 필요할 때 Moth 스킬의 안내를 받아 자체 검색 도구를 사용할 수 있습니다.

안전성

• 기본적으로 읽기 전용

• 소스 편집 없음

• 셸 실행 없음

• 저장소 전체 스캔 없음

• 백그라운드 감시자 없음

• 외부 서비스 불필요

• 분석, 응답 및 메모리 쓰기 전에 잠재적인 비밀 정보를 마스킹함

개발

pnpm install
pnpm test
pnpm build
pnpm dev
npm pack --dry-run

라이선스

MIT