Laravel 문서 MCP 서버

AI 어시스턴트와 언어 모델에 대한 Laravel 문서와 패키지 추천에 대한 액세스를 제공하는 MCP(모델 컨텍스트 프로토콜) 서버입니다.

개요

이 서버는 AI 어시스턴트가 모델 컨텍스트 프로토콜(MCP)을 사용하여 Laravel 문서 및 패키지 추천에 접근할 수 있도록 지원합니다. AI 도구는 이 서버를 통해 다음과 같은 작업을 수행할 수 있습니다.

Laravel 문서에 접근하고 검색하세요
특정 사용 사례에 따른 패키지 추천을 받으세요
인기 있는 Laravel 패키지에 대한 구현 지침을 받으세요
Laravel의 GitHub 저장소에서 문서를 자동으로 업데이트합니다.

설치

Smithery를 통한 빠른 설치

지엑스피1

수동 설치

필수 조건

파이썬 3.12+
uv 패키지 관리자(추천)

단계

저장소를 복제합니다.
git clone https://github.com/yourusername/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 .

용법

서버 시작

python laravel_docs_server.py

서버는 처음 실행 시 자동으로 Laravel 문서를 가져오며 Ctrl+C로 중지할 수 있습니다.

명령줄 옵션

옵션	설명
`--docs-path PATH`	문서 디렉토리 경로(기본값: ./docs)
`--server-name NAME`	서버 이름(기본값: LaravelDocs)
`--log-level LEVEL`	로그 수준: DEBUG, INFO, WARNING, ERROR, CRITICAL(기본값: INFO)
`--transport TYPE`	전송 방식: stdio, websocket, sse (기본값: stdio)
`--host HOST`	바인딩할 호스트(네트워크 전송)
`--port PORT`	수신할 포트(네트워크 전송)
`--version VERSION`	Laravel 버전 브랜치(기본값: 12.x)
`--update-docs`	시작하기 전에 문서를 업데이트하세요
`--force-update`	강제 문서 업데이트

사용자 정의 옵션의 예:

python laravel_docs_server.py --docs-path /path/to/docs --version 11.x --update-docs --transport websocket --host localhost --port 8000

문서 업데이터

설명서를 별도로 업데이트할 수 있습니다.

# Update documentation
python docs_updater.py --target-dir ./docs --version 12.x

# Check if update is needed
python docs_updater.py --check-only

# Force update
python docs_updater.py --force

API 참조

클라이언트 예

import asyncio
from fastmcp import Client

async def main():
    client = Client("path/to/laravel_docs_server.py")
    
    async with client:
        # List documentation
        result = await client.call_tool("list_docs", {})
        print(result)
        
        # Search documentation
        result = await client.call_tool("search_docs", {"query": "routing"})
        print(result)
        
        # Get package recommendations
        result = await client.call_tool("get_package_recommendations", 
                                       {"use_case": "implementing subscription billing"})
        print(result)
        
        # Read documentation
        resource = await client.read_resource("laravel://routing.md")
        print(resource)

if __name__ == "__main__":
    asyncio.run(main())

사용 가능한 도구

문서화 도구

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://{path}

예:

laravel://routing.md
laravel://authentication.md

기능 및 로드맵

현재 특징:

✅ Laravel의 GitHub 저장소에서 동적 문서 업데이트
✅ 우아한 종료 처리
✅ 명령줄 옵션을 통한 버전 유연성
✅ 사용 사례에 따른 패키지 추천
✅ 일반적인 Laravel 패키지에 대한 구현 지침
✅ Docker 배포 지원

계획된 기능:

다중 버전 지원(여러 Laravel 버전에 대한 문서에 동시에 액세스)
맞춤형 추천을 위한 사용자 프로젝트 분석

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.

기여하다

기여를 환영합니다! 자세한 내용은 CONTRIBUTING.md를 참조하세요.

감사의 말

Laravel의 훌륭한 문서
생태계에 기여한 Laravel 패키지 작성자

Laravel 12 Docs MCP Server

Integrations