Claude를 활용해 구축한 전체 BBS/FidoNet 플랫폼: BinktermPHP 개발기

실용적 조언

LLM과 협업할 때 프로젝트 루트에 컨벤션과 규칙을 담은 가이드 파일(예: CLAUDE.md)을 두어 일관성을 유지하라.
복잡한 레거시 프로토콜 구현 시 LLM에게 명확한 사양과 단계별 요구사항을 제공하여 오류를 최소화하라.

섹션별 상세

사용자가 아키텍트로서 의사결정을 내리고 Claude가 구현을 담당하는 협업 모델을 적용했다. 사용자가 요구사항을 정의하면 Claude가 PHP 8 기반의 코드 작성, 데이터베이스 마이그레이션, 디버깅을 수행했다. 프로젝트 저장소 내의 CLAUDE.md 파일을 통해 아키텍처 규칙과 컨벤션을 명시함으로써 LLM이 프로젝트의 일관된 맥락을 유지하도록 유도했다.

1980년대 기술인 TCP 기반 binkp 프로토콜을 바닥부터 구현했다. 세션 협상, 패킷 파싱, 인바운드/아웃바운드 큐잉 및 폴링 스케줄링 등 복잡한 통신 로직을 Claude가 성공적으로 코딩했다. 이는 LLM이 현대적 웹 기술뿐만 아니라 문서화된 고전적 프로토콜의 정교한 구현에도 효과적임을 입증했다.

현대적 웹 기술인 SharedWorker 기반의 실시간 이벤트 버스 'BinkStream'을 통합했다. 페이지 이동 시에도 상태가 유지되며 여러 탭에 서버 이벤트를 동기화하는 구조를 통해 중복 연결을 방지했다. Telnet, SSH, FTP 서버 기능을 포함하여 고전적 터미널 접속과 현대적 웹 인터페이스를 동시에 지원하는 하이브리드 시스템을 완성했다.

Node.js 기반의 MCP 서버를 구축하여 AI와의 상호작용을 강화했다. 베어러 토큰 인증을 통해 Claude가 BBS의 에코메일 데이터를 직접 읽을 수 있는 환경을 조성했다. 이는 AI가 자신이 구축에 참여한 시스템의 데이터를 이해하고 활용할 수 있게 함으로써 개발 도구 이상의 역할을 수행하게 했다.

용어 해설

Binkp 프로토콜(Binkp): — 1980년대부터 FidoNet에서 사용된 TCP 기반의 스토어 앤 포워드(Store-and-forward) 방식 메일 전송 프로토콜이다. 세션 협상, 패킷 파싱, 인바운드/아웃바운드 큐잉 등 복잡한 통신 절차를 포함하며 레거시 네트워크 시스템의 핵심 구성 요소이다.
모델 컨텍스트 프로토콜(MCP): — Model Context Protocol의 약자로, AI 모델이 외부 데이터 소스나 도구에 안전하고 표준화된 방식으로 접근할 수 있도록 돕는 프로토콜이다. 이 프로젝트에서는 BBS의 데이터를 Claude가 직접 읽을 수 있도록 연결하는 인터페이스 역할을 수행한다.
공유 워커(SharedWorker): — 브라우저의 여러 탭이나 창에서 공통으로 사용할 수 있는 백그라운드 스크립트이다. 중복 연결 없이 여러 페이지 간에 실시간 서버 이벤트를 동기화하고 상태를 유지하는 데 사용되어 웹 애플리케이션의 효율성을 높인다.
피도넷(FidoNet): — 1980년대에 시작된 전 세계적인 컴퓨터 네트워크 시스템으로, 전화선을 이용한 BBS 간 통신에 기반한다. 에코메일(게시판)과 넷메일(개인 메시지) 시스템을 통해 인터넷 보급 전 데이터 교환의 중추 역할을 했다.
Z모뎀(ZMODEM): — 파일 전송 중 오류가 발생해도 중단된 지점부터 다시 전송할 수 있는 이어받기 기능을 지원하는 고전적인 파일 전송 프로토콜이다. BBS 환경에서 대용량 파일을 안정적으로 주고받기 위해 널리 사용됐다.

언급된 도구

Claude추천

코드 구현, 데이터베이스 마이그레이션, 디버깅 및 프로토콜 로직 작성

PHP 8중립

BBS 플랫폼의 주력 개발 언어

PostgreSQL중립

데이터베이스 관리 시스템

Node.js중립

MCP 서버 구현

언급된 리소스

GitHubBinktermPHP GitHub Repository

DemoClaude's BBS Demo

문서Project Site