Laravel 12 문서 MCP 서버

Laravel 문서 MCP 서버

⚠️ 알파 소프트웨어 - 이 프로젝트는 초기 개발 단계에 있습니다. 기능이 예상대로 작동하지 않을 수 있으며, 예고 없이 중대한 변경 사항이 발생할 수 있습니다.

Laravel 개발자를 위한 AI 어시스턴트로, 모델 컨텍스트 프로토콜(MCP)을 통해 최신 Laravel 문서와 지능형 패키지 추천에 대한 접근을 제공합니다. 이를 통해 AI 도구는 최신 정보와 모범 사례를 활용하여 Laravel 애플리케이션을 구축할 수 있도록 지원합니다.

개요

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

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

설치

Smithery를 통한 빠른 설치

지엑스피1

PyPI에서 설치

pip install laravel-docs-mcp

도커

# Pull and run the latest version
docker run -p 8000:8000 ghcr.io/brianirish/laravel-docs-mcp:latest

# Or run a specific version
docker run -p 8000:8000 ghcr.io/brianirish/laravel-docs-mcp:v0.1.4

소스에서 수동 설치

필수 조건

파이썬 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 .

용법

서버 시작

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

자동화된 워크플로

이 프로젝트에는 여러 가지 자동화된 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 패키지 작성자

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

AI 어시스턴트와 언어 모델이 Laravel 12 문서에 액세스하여 문서 파일을 나열하고 읽고 검색할 수 있도록 하는 모델 컨텍스트 프로토콜 서버입니다.

Related MCP Servers

DevDocs MCP
llmian-space
-
security
A
license
-
quality
A Model Context Protocol implementation that enables AI-powered access to documentation resources, featuring URI-based navigation, template matching, and structured documentation management.
Last updated -
3
Python
MIT License
MPC Docs Server
joaowinderfeldbussolotto
-
security
F
license
-
quality
A simple Model Context Protocol server that enables searching and retrieving relevant documentation snippets from Langchain, Llama Index, and OpenAI official documentation.
Last updated -
Python
Docs MCP Server
buger
A
security
A
license
A
quality
A flexible Model Context Protocol server that makes documentation or codebases searchable by AI assistants, allowing users to chat with code or docs by simply pointing to a git repository or folder.
Last updated -
1
31
19
JavaScript
MIT License
doc-lib-mcp
shifusen329
-
security
F
license
-
quality
A Model Context Protocol server for ingesting, chunking and semantically searching documentation files, with support for markdown, Python, OpenAPI, HTML files and URLs.
Last updated -
Python

View all related MCP servers

Laravel 12 Docs MCP Server