OpenAPI와 MCP 기반 AI-Readable PHP API 프레임워크 NENE2 설계

I built a tiny PHP framework for AI-readable business APIs

HideyukiMORI2026년 6월 22일5분intermediate

AI 요약

Context

기존 Full-stack 프레임워크의 과도한 추상화와 Magic으로 인한 시스템 가독성 저하 발생. AI 에이전트가 직접 DB에 접근할 때 발생하는 보안 리스크 및 비즈니스 로직 우회 문제 해결 필요.

OpenAPI 3.1 기반의 Contract-First 설계를 통한 HTTP 경계의 명시적 정의
HTTP Handler → Use Case → Repository Interface → PDO Adapter로 이어지는 Boring Architecture 채택으로 코드 가시성 확보
RFC 9457 Problem Details 표준을 적용한 예측 가능한 에러 응답 구조 설계
MCP(Model Context Protocol) Tool Catalog를 API 경계에 배치하여 AI 에이전트의 DB 직접 접근을 차단하고 API를 통한 제어권 유지
PSR-7, 15, 17 표준 런타임 및 PSR-11 DI 도입으로 프레임워크 의존성 최소화 및 상호운용성 강화

실천 포인트

1. AI 에이전트에게 DB 권한 대신 문서화된 API Tooling 권한 부여

2. 프레임워크 컨벤션보다 파일 트리에서 비즈니스 흐름이 보이는 명시적 구조 설계

3. OpenAPI 스펙을 단순 문서가 아닌 런타임 계약 검증 및 클라이언트 생성의 Single Source of Truth로 활용

4. 비즈니스 로직(Use Case)과 인프라 계층(PDO Adapter)의 엄격한 분리를 통한 테스트 용이성 확보

태그