-
- 로그인후 이용해주세요.
자유 게시판
2026.04.20 16:24
클로드코드용 그누보드 MCP 를 만들어봤어요
요즘 클로드코드(맥스20은 필수재 ㅎㅎ)로 이런 저런 프로젝트를 만드는걸 하고 있어요
그런데 react, 파이썬 등과 다르게 php 기반의 그누보드 코딩 작업만큼은 영 부정확하더라구요. 이유야 뻔해요
PHP/그누보드 학습 데이터가 다른 생태계에 비해서 거의 없고, 있어 봤자 과거 정보들이 많아서 잘 안 맞아요. 코딩방식도 AI가 이해하기 쉬운 구조가 아니죠.
그누보드5 5.6.x 기준으로 짜달라고 해도 그냥 적당히 지어내서 지어내는 경우가 허다함;
더 답답한 건 이미 코어에 있는 함수를 안 쓰고 비슷한 걸 새로 만들어버리는 경우가 허다하다는 거예요.
예를 들어 get_paging() 가져다 쓰면 한 줄인데 굳이 페이지네이션 로직을 처음부터 짜요. 훅 시스템도 이해 못해서 코어 파일을 직접 수정하는 식으로 풀려고 하구요
skin/, extend/, adm/, mobile/ 의 책임 분리도 자주 헷갈려해요. 전체 구조에 대한 감이 부족하다고 느껴요
그래서 바이브코딩 할때마다 매번 세션마다 "그누보드는 이런 구조고, 이 함수가 있고, 이 훅을 써야 한다" 일일이 학습시키는 게 힘들고 귀찮아서, 결국 자료를 직접 모았어요 ㅋㅋ
그누보드5 5.6.24(최신) 코어 GitHub — 함수 394개, 훅 119개, G5_* 상수 143개를 정적 분석으로 자동 추출
sir.kr — 그누보드에서 자생적으로 십수년간 쌓여온 각종 꿀팁(Tip / 강좌 / Q&A), 기타 공신력 있는 소스들 모두 수집하여 다듬고 적용
합쳐서 약 1,900개 atom(지식 단위 1개 = 1개 markdown 파일)이에요
물론 외부 자료는 버전 차이에 따른 이슈가 있으니까, 코어 GitHub 출처만 official 등급, 외부는 verified / community / experimental 로 등급을 매겨뒀어요
클로드코드가 답변할 때 등급에 따라 참조 비중을 자동 조절하고, 어디까지나 참조사항 정도로 사용하게 해뒀구요
그냥 markdown으로만 두면 매 세션 다시 읽혀야 해서 의미가 없더라구요. 그래서 이렇게 구성했어요
SQLite에 색인 (FTS5 풀텍스트 + sqlite-vec 벡터)
하이브리드 검색 — "글 수정 후 처리" 같은 자연어로 물어도 write_update_after 훅이 잡힘
출처 추적 — 답변마다 GitHub 파일:라인, sir.kr 게시글 URL, 라이선스까지 함께 표시
잠깐 테스트해보니 환각 0에 없는 함수는 안 나옴
이걸 MCP 서버로 만들었어요. Claude Code에 한 번 등록해두면 끝이에요. 도구 이름 외울 필요도 없고, 그누보드 관련 질문 던지면 알아서 검색해서 답해주고, 만들어줘요.
이제는 클로드코드로 그누보드 작업할 때 구축된 일종의 위키를 기반으로 이렇게 돌아감
- 자연어로 "본인이 쓴 글만 보이게 하려면" 물으면 : 관련 sir.kr 글 + 필요한 코어 함수 시그니처 묶어서 답이 나옴
- "이거 어떤 훅에서 처리해야 함?" 물으면 : 정확한 훅 이름 + 호출 위치 + 인자 시그니처 즉답이에요
- 코드 짜달라고 하면 : 이미 있는 코어 함수를 먼저 활용하는 방향으로 짜줘요 (제일 큰 변화)
- 디렉토리 구조 / 레이어 분리도 인지하고 있어서 "이건 extend/에 두는 게 맞다" 식으로 알맞게 배치해줘요
별도로 웹에서도 볼 수 있게 해두었는데, 사실 볼일은 딱히 없을것같고. 어차피 챗봇처럼 그냥 물어보면 답하니까요
아무튼 카테고리별 atom 탐색 / 검색 / 다크모드 / 키보드 단축키 등 위키 기능 일반이에요
* 리빌더대표님께 : 작년에 외주를 요청드리고 아직도 개발 착수를 못하게, 제가 정보를 못드리고 있는데 빠르게 서두르겠습니다 ㅠ_ㅠ
- 다음글그누 패치한지 얼마안되었는데2026.04.17
댓글목록
등록된 댓글이 없습니다.
