🚀 Darkwood 기사 게시용 PHP MCP 애플리케이션 생성

Source: Dev.to

대형 언어 모델은 이미 텍스트 생성에 있어 뛰어난 성능을 보여줍니다.
많은 프로젝트에서 아직 부족한 것은 이 생성 과정을 진정한 워크플로우로 전환하는 간단한 방법입니다: 초안을 작성하고, 검토하고, 교정하고, 게시하고, AI 클라이언트 애플리케이션에 직관적으로 통합하는 것.

바로 여기서 MCP(Model‑Centered Programming) 애플리케이션이 흥미로워집니다.

MCP 애플리케이션이 중요한 이유

MCP 애플리케이션은 더 실용적인 기능을 추가합니다: 도구가 자체 내장 사용자 인터페이스를 통합할 수 있게 합니다.
이는 상호작용 모델을 크게 변경합니다:

• 텍스트만 반환하는 대신, 도구는 이제 호스트 시스템 내에서 전용 인터페이스를 열 수 있습니다.
• 이 인터페이스는 입력 상태를 표시하고, 결과를 제시하며, 사용자를 전체 흐름에 걸쳐 안내하고, 추가 도구 호출을 트리거할 수 있습니다.
• 도구는 단순한 원격 함수가 아니라 완전한 애플리케이션 인터페이스처럼 동작하게 됩니다.

편집 워크플로우에서는 이 모델이 단순한 순수 텍스트보다 훨씬 적합합니다.

사용 사례: Darkwood 블로그 글 게시

이 MCP 애플리케이션은 Darkwood에 블로그 글을 게시하는 과정을 용이하게 합니다. 작업 흐름은 두 가지 주요 단계로 구성됩니다:

1. GenerateDraft – 주제나 컨텍스트를 기반으로 초기 초안을 생성합니다.
2. PublishDraft – 게시 과정을 관리합니다.

Note: 초안이 아직 만족스럽지 않다면, 프로세스를 계속 진행할 수 있습니다. 새로 게시를 시도하기 전에 뒤로 돌아가 수정하거나 재검토할 수 있습니다. 이 반복 루프는 매우 중요합니다. 첫 번째 초안은 종종 너무 조잡하고, 일반적이며, 길이가 길거나 편집 의도와 맞지 않기 때문입니다.

MCP 서버, 활용 방법 여러 가지

서버는 다양한 전송 방식을 통해 사용할 수 있습니다:

참고: MCP 애플리케이션이 포함될 경우, 사용자 인터페이스는 다른 JSON‑RPC 채널(보통 postMessage)을 통해 호스트와 통신합니다. 따라서 두 단계의 통신이 존재합니다:

• 호스트 ↔ 서버 via MCP,
• UI 인터페이스 ↔ 호스트 via postMessage.

MCP 연결의 수명 주기

1. 초기화 – 호스트가 연결을 초기화하고 서버의 기능을 탐색합니다.
2. 디스커버리 – 호스트가 사용 가능한 도구와 리소스를 나열합니다.
3. 호출 – 사용자가 도구를 트리거하면 호스트가 서버에서 해당 도구를 호출합니다.
4. UI 리소스 – 도구에 인터페이스 리소스(ui://…)가 있는 경우, 호스트가 해당 리소스를 로드하고 격리된 iframe에 표시합니다.
5. 상호작용 – MCP 애플리케이션이 인터랙티브해집니다: 입력 데이터를 받고, 결과를 표시하며, 호스트를 통해 추가 작업을 트리거합니다.

Darkwood 작업 흐름에서는 사용자가(또는 어시스턴트가) 초안 생성에서 게시로 이동한 뒤, 수정 루프로 다시 돌아갈 수 있으며, 전체 과정이 MCP 인터랙션 모델을 떠나지 않고 이루어집니다.

아키텍처

개요

+-------------------+        +-------------------+
|   Hôte MCP        |  |   Serveur PHP     |
| (client)          |        | (MCP server)      |
+-------------------+        +-------------------+
        ^                               ^
        |                               |
        | JSON‑RPC (Stdio / HTTP)       |
        |                               |
        v                               v
+-------------------+        +-------------------+
|   Interface UI   |  |   Ressources UI   |
+-------------------+        +-------------------+

Un hôte MCP se connecte au serveur PHP.
MCP 호스트가 PHP 서버에 연결합니다.

Cette séparation permet de conserver une interface utilisateur portable sur les hôtes compatibles tout en préservant un contrat MCP propre côté serveur.
이 분리를 통해 호환 가능한 호스트에서 휴대 가능한 사용자 인터페이스를 유지하면서 서버 측에서 MCP 계약을 깔끔하게 보존할 수 있습니다.

상세 전송 방식

Stdio

• Idéal pour les extensions Claude Desktop.
  Claude Desktop 확장에 이상적입니다.
• L’hôte lance le serveur, échange des messages JSON‑RPC via stdin/stdout.
  호스트가 서버를 실행하고 stdin/stdout을 통해 JSON‑RPC 메시지를 교환합니다.
• Simple, local et efficace lorsque le client gère les processus.
  클라이언트가 프로세스를 관리할 때 간단하고 로컬이며 효율적입니다.

HTTP

• Utile pour les hôtes orientés navigateur, les tests locaux ou toute configuration où une limite HTTP est plus pratique.
  브라우저 기반 호스트, 로컬 테스트 또는 HTTP 제한이 더 편리한 모든 구성에 유용합니다.
• Deux modes d’implémentation :
  1. Processus dédié et persistant (ex. : flow worker).
     전용 지속 프로세스 (예: flow worker).
  2. Serveur HTTP classique (ex. : Symfony Server).
     전통적인 HTTP 서버 (예: Symfony Server).

Important : « prend en charge HTTP » ne signifie pas automatiquement « prend en charge le même modèle d’exécution partout ».
중요: “HTTP를 지원한다”는 것이 자동으로 “모든 곳에서 동일한 실행 모델을 지원한다”는 의미는 아닙니다.

• Avec Stdio ou un worker HTTP persistant, on peut envisager un processus persistant, ouvrant la voie à des fonctionnalités asynchrones, des boucles d’événements et une orchestration continue.
  Stdio 또는 지속 HTTP 워커를 사용하면 지속 프로세스를 고려할 수 있으며, 비동기 기능, 이벤트 루프 및 지속적인 오케스트레이션을 구현할 수 있습니다.
• Avec Symfony Server, chaque requête est traitée dans un cycle HTTP synchrone : plus simple à mettre en œuvre, mais l’orchestration du workflow doit être déléguée (ex. : couche Flow ou coordination externe).
  Symfony Server를 사용할 경우 각 요청이 동기 HTTP 사이클에서 처리됩니다: 구현은 더 간단하지만 워크플로 오케스트레이션은 (예: Flow 레이어 또는 외부 조정)으로 위임해야 합니다.

편집 흐름 관리

1. 초기화 – 호스트는 전송, 렌더링 및 사용자 인터페이스와 서버 간의 연결을 관리합니다.
2. 오케스트레이션 – Flow 레이어는 여러 작업 및 상태 전환이 포함된 워크플로를 조정합니다.

편집 흐름은 종종 하나 이상의 작업 및 하나 이상의 상태 전환을 포함합니다; Flow 레이어는 이러한 단계가 올바르게 조정되도록 보장합니다.

결론

MCP 애플리케이션은 통합 사용자 인터페이스를 제공하여 단순 텍스트 생성을 전체 워크플로로 전환합니다: 작성, 검토, 출판 및 반복.
Darkwood 상황에서 이는 다음을 가능하게 합니다:

• 첫 번째 초안을 빠르게 생성합니다.
• MCP 환경을 떠나지 않고 쉽게 반복(수정, 검토)합니다.
• 최종 콘텐츠를 원활하게 출판합니다.

Stdio와 HTTP 전송 방식을 명확한 아키텍처(호스트 ↔ 서버 ↔ UI)와 결합함으로써, 개발자는 풍부하고 반응성이 뛰어나며 쉽게 확장 가능한 편집 경험을 만들 수 있습니다.

이 설계가 출판 워크플로에 효과적인가?

단순한 함수 호출도 아니고, 완전한 백오피스 애플리케이션도 아닙니다.
상태와 의사결정을 관리할 충분한 구조가 필요하면서도, AI와의 대화로 트리거될 수 있을 만큼 가벼워야 합니다.

바로 MCP 애플리케이션이 여기서 완벽하게 맞는 이유입니다.

각 계층의 역할

• 도구 인터페이스 – 모델에 상호작용 표면을 제공합니다.
• 사용자 인터페이스 – 사용자 또는 클라이언트에게 워크플로의 제어된 뷰를 제공합니다.
• 플로우 오케스트레이션 – 시스템이 다단계 전환을 관리하도록 합니다.

이 조합이 효과적인 이유는 각 계층이 명확한 목적에 집중하기 때문입니다:

• 모델이 언제 도구를 사용할지 결정하고,
• 프로젝트가 단순히 로컬 프로토타입이나 브라우저 데모에 그치지 않고; Claude에 설치되어 실제 도구 통합으로 활용될 수 있습니다.

구성

1. 확장 프로그램 매니페스트 – Claude가 서버를 실행하는 방식을 정의합니다.
2. 프로토타입에서 실제 편집 도구로 – 프로젝트는 이미 편집 도구를 위한 재사용 가능한 형태를 정의하고 있습니다:
   • 초안을 만들기 위한 도구,
   • 이 구조가 마련되면 작업 흐름 개선이 훨씬 간단해집니다:
     • 생성 품질 최적화,
     • 출판 메타데이터 강화,
     • 검증 추가,
     • 실제 CMS 통합.

호스팅 제공자, 사용자 인터페이스 및 서버 간의 계약은 안정적으로 유지됩니다.

오픈 소스

https://github.com/darkwood-com/darkwood-publish-article-mcp-apps

결론

Darkwood의 경우 가장 흥미로운 점은 PHP가 MCP와 통신할 수 있다는 것이 아니라,
PHP MCP 서버가 이제 AI 클라이언트에서 접근 가능한 작은 편집 애플리케이션의 백엔드 역할을 할 수 있다는 점이다. 이때:

• 도구의 의미론,
• 통합된 사용자 인터페이스

를 동시에 제공한다.

이는 “모델이 함수를 호출할 수 있다”는 통합을 “모델이 제어된 출판 워크플로에 참여할 수 있다”는 수준으로 끌어올린다.
그리고 이는 훨씬 더 유용한 영역이다.

출처

• MCP 애플리케이션 빠른 시작 – README.md
• php‑mcp‑apps의 MVP 아키텍처 – php-mcp-apps-mvp-architecture.md