dtyq/php-mcp

**Model Context Protocol (MCP)**의 완전한 PHP 구현체로, 다양한 전송 프로토콜 (transport protocols)을 지원하며 서버와 클라이언트 기능을 모두 제공합니다.

• 🚀
  최신 MCP 프로토콜- MCP 2025-03-26 사양 지원 - 🔧
  완전한 구현- 도구 (Tools), 리소스 (resources), 프롬프트 (prompts) 지원 - 🔌
  다양한 전송 방식- STDIO ✅, HTTP ✅, Streamable HTTP 🚧 - 🌐
  프레임워크 호환성- 모든 PSR 준수 프레임워크와 작동하며, Hyperf 통합 기능 내장 - 📚
  잘 정리된 문서- 영어 및 중국어로 제공되는 포괄적인 가이드

composer require dtyq/php-mcp

Hyperf 프레임워크를 사용하는 경우, 통합이 매우 간단합니다:

// 단 한 줄의 코드만 필요합니다!
Router::addRoute(['POST', 'GET', 'DELETE'], '/mcp', function () {
return \Hyperf\Context\ApplicationContext::getContainer()->get(HyperfMcpServer::class)->handle('default');
...

어노테이션 기반 등록 (Annotation-Based Registration):

class CalculatorService
{
#[McpTool(description: 'Mathematical calculations')]
...

고급 옵션:

• 🔐
  AuthenticatorInterface- 사용자 정의 인증 - 📊
  HttpTransportAuthenticatedEvent- 동적 도구/리소스 등록 - 📝
  어노테이션 시스템 (Annotation System)- 도구, 리소스 및 프롬프트 자동 등록

<?php
require_once 'vendor/autoload.php';
use Dtyq\PhpMcp\Server\McpServer;
...

<?php
use Dtyq\PhpMcp\Client\McpClient;
use Dtyq\PhpMcp\Client\Configuration\StdioConfig;
...

대체 방법:

// HTTP 단축 메서드
use Dtyq\PhpMcp\Client\Configuration\HttpConfig;
$httpConfig = new HttpConfig('http://localhost:8080/mcp');
...

📚 전체 문서- 모든 가이드 및 참조
📖 프로젝트 개요- 아키텍처, 기능 및 사용 사례
🚀 빠른 시작 가이드- 5분 튜토리얼
🔧 서버 가이드- MCP 서버 구축
📡 클라이언트 가이드- MCP 클라이언트 생성

/examples 디렉토리를 확인하세요:

stdio-server-test.php - 완전한 STDIO 서버
http-server-test.php - 도구가 포함된 HTTP 서버
stdio-client-test.php

• STDIO 클라이언트 예제 http-client-test.php

• HTTP 클라이언트 예제

프로토콜 (Protocol)	상태 (Status)	설명 (Description)
STDIO	✅	프로세스 통신 (Process communication)
...

PHP: 7.4+ (8.0+ 권장)
확장 모듈 (Extensions): json, mbstring, openssl, pcntl, curl
Composer: 의존성 관리 (Dependency management) 용

기여를 환영합니다! 도움을 줄 수 있는 분야는 이슈(issues) 페이지를 확인해 주세요.

git clone https://github.com/dtyq/php-mcp.git
cd php-mcp
composer install
...

MIT License - 자세한 내용은 LICENSE 파일을 참조하세요.

• 사양(specification)을 위한 Model Context Protocol
• MCP를 만든 Anthropic
• 훌륭한 도구와 지원을 제공하는 PHP 커뮤니티

⭐ 이 저장소가 유용하다고 생각되면 Star를 눌러주세요!