Laravel 문서 MCP 서버
⚠️ 알파 소프트웨어 - 이 프로젝트는 초기 개발 단계에 있습니다. 기능이 예상대로 작동하지 않을 수 있으며, 예고 없이 중대한 변경 사항이 발생할 수 있습니다.
Laravel 개발자를 위한 AI 어시스턴트로, 모델 컨텍스트 프로토콜(MCP)을 통해 최신 Laravel 문서와 지능형 패키지 추천에 대한 접근을 제공합니다. 이를 통해 AI 도구는 최신 정보와 모범 사례를 활용하여 Laravel 애플리케이션을 구축할 수 있도록 지원합니다.
개요
이 서버는 AI 어시스턴트가 모델 컨텍스트 프로토콜(MCP)을 사용하여 Laravel 문서 및 패키지 추천에 접근할 수 있도록 지원합니다. AI 도구는 이 서버를 통해 다음과 같은 작업을 수행할 수 있습니다.
Laravel 문서에 접근하고 검색하세요
특정 사용 사례에 따른 패키지 추천을 받으세요
인기 있는 Laravel 패키지에 대한 구현 지침을 받으세요
Laravel의 GitHub 저장소에서 문서를 자동으로 업데이트합니다.
Related MCP server: MPC Docs Server
설치
Smithery를 통한 빠른 설치
지엑스피1
PyPI에서 설치
도커
소스에서 수동 설치
필수 조건
파이썬 3.12+
uv패키지 관리자(추천)
단계
저장소를 복제합니다.
git clone https://github.com/brianirish/laravel-docs-mcp.git cd laravel-docs-mcp환경 설정 및 종속성 설치:
# Create and activate virtual environment uv venv source .venv/bin/activate # Linux/macOS # or .venv\Scripts\activate # Windows # Install dependencies uv pip install .
용법
서버 시작
서버는 처음 실행 시 자동으로 Laravel 문서를 가져오며 Ctrl+C로 중지할 수 있습니다.
명령줄 옵션
옵션 | 설명 |
| 문서 디렉토리 경로(기본값: ./docs) |
| 서버 이름(기본값: LaravelDocs) |
| 로그 수준: DEBUG, INFO, WARNING, ERROR, CRITICAL(기본값: INFO) |
| 전송 방식: stdio, websocket, sse (기본값: stdio) |
| 바인딩할 호스트(네트워크 전송) |
| 수신할 포트(네트워크 전송) |
| Laravel 버전 브랜치(기본값: 12.x) |
| 시작하기 전에 문서를 업데이트하세요 |
| 강제 문서 업데이트 |
사용자 정의 옵션의 예:
문서 업데이터
설명서를 별도로 업데이트할 수 있습니다.
API 참조
클라이언트 예
사용 가능한 도구
문서화 도구
list_docs()- 모든 문서 파일 나열search_docs(query: str)- 특정 용어로 문서 검색update_docs(version: Optional[str], force: bool)- 문서 업데이트docs_info()- 문서 버전 정보 가져오기
패키지 추천 도구
get_package_recommendations(use_case: str)- 사용 사례에 대한 패키지 권장 사항을 가져옵니다.get_package_info(package_name: str)- 특정 패키지에 대한 세부 정보를 가져옵니다.get_package_categories(category: str)- 특정 카테고리의 패키지 나열get_features_for_package(package: str)- 패키지에 사용 가능한 기능을 가져옵니다.
리소스 액세스
문서 파일은 다음을 사용하여 리소스로 액세스할 수 있습니다.
예:
laravel://routing.mdlaravel://authentication.md
자동화된 워크플로
이 프로젝트에는 여러 가지 자동화된 GitHub Actions 워크플로가 포함되어 있습니다.
일일 문서 업데이트
트리거 : 매일 자정 UTC(수동으로 트리거 가능)
프로세스 : Laravel 문서 업데이트 확인 → PR 생성 → 자동 병합 → 패치 버전 태그 생성
결과 : Laravel 문서가 업데이트되면 자동 패치 릴리스
릴리스 게시
트리거 : 버전 태그가 푸시될 때(예:
v0.1.4)프로세스 : 패키지 빌드 → PyPI에 게시 → Docker 이미지를 빌드하고 GHCR에 푸시
결과 : PyPI와 Docker Hub에서 동기화된 릴리스
동적 버전 관리
버전 소스 :
hatch-vcs사용하여 git 태그에서 자동으로 파생됨개발 빌드 : 고유 식별자 가져오기(예:
0.1.3.dev1+g75aec71)릴리스 빌드 : 태그와 일치하는 깔끔한 버전 번호(예:
0.1.4)
기능 및 로드맵
현재 특징:
✅ 매일 문서 업데이트 : 매일 Laravel의 GitHub 저장소와 자동으로 동기화됩니다.
✅ 동적 버전 관리 : git 태그를 기반으로 한 자동 버전 관리
✅ 자동 릴리스 : 문서 업데이트에 따라 트리거되는 패치 릴리스
✅ 다양한 배포 옵션 : PyPI 패키지, Docker 이미지, Smithery 마켓플레이스
✅ 패키지 추천 : 특정 사용 사례에 기반한 지능형 제안
✅ 구현 지침 : 일반적인 Laravel 패키지에 대한 자세한 정보
✅ 유연한 구성 : 다양한 Laravel 버전 및 전송 방법 지원
✅ 우아한 종료 : 적절한 정리 및 신호 처리
계획된 기능:
🔄 다중 버전 지원(여러 Laravel 버전에 대한 문서에 동시에 액세스)
🔍 맞춤형 추천을 위한 사용자 프로젝트 분석
🚀 의미적 매칭을 통한 향상된 검색 기능
📊 사용 분석 및 통찰력
🔗 추가 Laravel 생태계 통합
특허
이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.
기여하다
기여를 환영합니다! 자세한 내용은 CONTRIBUTING.md를 참조하세요.
감사의 말
Laravel의 훌륭한 문서
생태계에 기여한 Laravel 패키지 작성자
