laravel-plugin-discovery

Laravel 플러그인 탐색

LaraPlugins.io MCP 서버를 사용해 건강한 Laravel 패키지를 찾고, 평가하고, 선택합니다.

사용 시점

• 사용자가 특정 기능용 Laravel 패키지를 찾고 싶을 때. 예: auth, permissions, admin panel
• 사용자가 "무슨 패키지를 써야 하나?", "Laravel 패키지가 있나?"라고 물을 때
• 패키지가 활발히 유지보수되는지 확인하고 싶을 때
• Laravel 버전 호환성을 검증해야 할 때
• 프로젝트에 추가하기 전에 패키지 상태를 점검하고 싶을 때

MCP 요구사항

LaraPlugins MCP 서버가 설정돼 있어야 합니다. ~/.claude.json의 mcpServers에 다음을 추가합니다.

"laraplugins": {
  "type": "http",
  "url": "https://laraplugins.io/mcp/plugins"
}

API 키는 필요 없습니다. 이 서버는 Laravel 커뮤니티를 위해 무료로 제공됩니다.

MCP 도구

LaraPlugins MCP는 두 가지 주요 도구를 제공합니다.

SearchPluginTool

키워드, 건강도 점수, 벤더, 버전 호환성 기준으로 패키지를 검색합니다.

파라미터:

• text_search (string, optional): 검색 키워드. 예: permission, admin, api
• health_score (string, optional): 건강도 밴드 필터. Healthy, Medium, Unhealthy, Unrated
• laravel_compatibility (string, optional): Laravel 버전 필터. "5" ~ "13"
• php_compatibility (string, optional): PHP 버전 필터. "7.4" ~ "8.5"
• vendor_filter (string, optional): 벤더 이름 필터. 예: spatie, laravel
• page (number, optional): 페이지네이션용 페이지 번호

GetPluginDetailsTool

특정 패키지의 상세 지표, README 내용, 버전 이력을 가져옵니다.

파라미터:

• package (string, required): 전체 Composer 패키지 이름. 예: spatie/laravel-permission
• include_versions (boolean, optional): 응답에 버전 이력을 포함할지 여부

---

동작 방식

패키지 찾기

사용자가 기능별 패키지를 찾고 싶다면:

1. 관련 키워드로 SearchPluginTool을 사용합니다.
2. 건강도, Laravel 버전, PHP 버전 필터를 적용합니다.
3. 패키지 이름, 설명, 건강도 지표를 기준으로 결과를 검토합니다.

패키지 평가

사용자가 특정 패키지를 평가하고 싶다면:

1. 패키지 이름으로 GetPluginDetailsTool을 사용합니다.
2. 건강도 점수, 최근 업데이트 시점, Laravel 지원 버전을 확인합니다.
3. 벤더 평판과 위험 지표를 검토합니다.

호환성 확인

사용자가 Laravel 또는 PHP 버전 호환성을 확인해야 한다면:

1. 자신의 버전으로 laravel_compatibility 필터를 설정해 검색합니다.
2. 또는 특정 패키지의 상세 정보를 열어 지원 버전을 확인합니다.

---

예시

예시: 인증 패키지 찾기

SearchPluginTool({
  text_search: "authentication",
  health_score: "Healthy"
})

authentication에 매칭되고 상태가 Healthy인 패키지를 반환합니다.

• spatie/laravel-permission
• laravel/breeze
• laravel/passport
• 기타

예시: Laravel 12 호환 패키지 찾기

SearchPluginTool({
  text_search: "admin panel",
  laravel_compatibility: "12"
})

Laravel 12와 호환되는 패키지를 반환합니다.

예시: 패키지 상세 정보 가져오기

GetPluginDetailsTool({
  package: "spatie/laravel-permission",
  include_versions: true
})

반환 항목:

• 건강도 점수와 최근 활동
• Laravel/PHP 버전 지원
• 벤더 평판(위험 점수)
• 버전 이력
• 간단한 설명

예시: 벤더별 패키지 찾기

SearchPluginTool({
  vendor_filter: "spatie",
  health_score: "Healthy"
})

벤더 spatie의 Healthy 패키지를 모두 반환합니다.

---

필터링 모범 사례

건강도 점수 기준

Health Band	의미
Healthy	활발히 유지보수되고 최근 업데이트가 있음
Medium	간헐적 업데이트, 주의 필요
Unhealthy	사실상 방치되었거나 업데이트가 드묾
Unrated	아직 평가되지 않음

권장: 운영 애플리케이션에는 Healthy 패키지를 우선합니다.

Laravel 버전 기준

Version	설명
13	최신 Laravel
12	현재 안정 버전
11	아직 널리 사용됨
10	레거시지만 흔함
5-9	지원 종료

권장: 대상 프로젝트의 Laravel 버전에 맞춥니다.

필터 조합

// 권한 기능용 Healthy + Laravel 12 호환 패키지 찾기
SearchPluginTool({
  text_search: "permission",
  health_score: "Healthy",
  laravel_compatibility: "12"
})

---

응답 해석

검색 결과

각 결과에는 다음이 포함됩니다.

• 패키지 이름. 예: spatie/laravel-permission
• 짧은 설명
• 건강 상태 표시
• Laravel 버전 지원 배지

패키지 상세 정보

상세 응답에는 다음이 포함됩니다.

• Health Score: 숫자 또는 밴드 기반 지표
• Last Activity: 최근 업데이트 시점
• Laravel Support: 버전 호환성 매트릭스
• PHP Support: PHP 버전 호환성
• Risk Score: 벤더 신뢰 지표
• Version History: 최근 릴리스 타임라인

---

일반 사용 사례

시나리오	권장 접근
"auth에는 어떤 패키지가 좋나?"	auth로 검색하고 Healthy 필터 적용
"spatie/package가 아직 유지보수되나?"	상세 정보 조회 후 health score 확인
"Laravel 12 패키지가 필요함"	laravel_compatibility: "12"로 검색
"admin panel 패키지 찾기"	admin panel로 검색 후 결과 검토
"벤더 평판 확인"	벤더 기준 검색 후 상세 정보 확인

---

모범 사례

1. 항상 건강도 기준으로 필터링 — 운영 프로젝트에서는 health_score: "Healthy"를 우선합니다.
2. Laravel 버전 일치 확인 — laravel_compatibility가 대상 프로젝트와 맞는지 항상 확인합니다.
3. 벤더 평판 확인 — spatie, laravel 같은 신뢰할 수 있는 벤더를 우선합니다.
4. 권고 전에 상세 검토 — GetPluginDetailsTool로 종합 평가를 수행합니다.
5. API 키 불필요 — MCP는 무료이며 인증이 필요 없습니다.

---

관련 스킬

• laravel-patterns — Laravel 아키텍처와 패턴
• laravel-tdd — Laravel 테스트 주도 개발
• laravel-security — Laravel 보안 모범 사례
• documentation-lookup — 일반 라이브러리 문서 조회(Context7)