logiscape/mcp-sdk-php

해결하는 문제

이 프로젝트는 Model Context Protocol (MCP)의 PHP 구현을 제공하여 PHP 개발자가 자신의 애플리케이션을 AI 모델과 통합할 수 있도록 합니다. 특히 프로세스가 일시적이고 무상태인 일반적인 PHP 웹 호스팅 환경(예: Apache 또는 cPanel)에서 MCP 서버와 클라이언트를 실행하는 문제를 해결합니다.

작동 방식

이 SDK는 전체 MCP 사양을 구현하며 클라이언트와 서버 역할을 모두 지원합니다. stdio 및 HTTP와 같은 표준 전송을 사용하여 통신합니다. 주요 기능은 "무상태 코어" 지원(사양 개정판 2026-07-28)으로, 초기화 핸드셰이크와 세션 ID의 필요성을 제거하여 웹 호스팅의 요청-응답 주기에 이상적입니다.

대상 독자

LLM 기반 클라이언트가 액세스할 수 있는 AI 기반 도구, 리소스 및 프롬프트를 구축하려는 PHP 개발자 또는 다른 MCP 서버에 연결하기 위해 MCP 클라이언트 역할을 하는 PHP 애플리케이션을 구축하려는 개발자.

주요 기능

• 무상태 코어 지원: 모든 요청에 대한 세션 ID와 핸드셰이크를 제거하여 PHP 웹 호스팅에 최적화되었습니다.
• 듀얼 에라 협상: 최신(2026-07-28) 및 레거시(2024-11-05) MCP 사양 간의 호환성을 자동으로 처리합니다.
• MCP Apps 확장: 개발자는 단일 메서드 호출로 호스트 렌더링된 HTML UI를 도구에 연결할 수 있습니다.
• Tasks 확장: 파일 기반 저장소를 통해 장기 실행 도구 호출을 지원하여 공유 호스팅에서 폴링 및 취소를 가능하게 합니다.
• 적합성 테스트 통과: 공식 MCP 적합성 테스트에서 높은 통과율을 유지합니다.
• CURL 및 JSON 지원: PHP 8.1+용으로 제작되었으며 외부 종속성이 최소화되었습니다.