classby-blog-mcp

스튜디오B(ClassBy) 블로그 글쓰기용 MCP 서버. 블로그 글 초안 작성/수정, 이미지 첨부, 네이버 블로그 글쓰기 화면에 자동으로 채워 넣는 도구를 제공합니다.

제공 도구

도구	설명
write_post_draft	새 블로그 글 초안 생성 (title, content, tags)
update_post_draft	기존 초안 수정
get_post_draft	초안 조회
list_post_drafts	초안 목록 조회
attach_image	로컬 이미지 파일을 초안에 첨부
naver_open_editor	네이버 블로그 글쓰기 화면을 Chrome으로 열기
naver_fill_editor	열린 화면에 초안 제목/본문 입력 (발행은 하지 않음)
naver_close_editor	자동화용 Chrome 창 닫기

naver_* 도구는 별도의 자동화 전용 Chrome 프로필 (~/.classby-blog-mcp/chrome-profile)을 사용합니다. 처음 실행 시 그 창에서 네이버에 한 번 로그인해두면 이후에도 로그인이 유지됩니다.

빌드

npm install
npm run build   # src/ -> dist/ 복사 + dist/build.json 버전 번호 기록

npm pack 실행 시 prepack 스크립트가 자동으로 npm run build를 실행하므로, 배포용 tgz에는 항상 최신 dist/가 포함됩니다.

Claude MCP 서버 등록 예시

Claude 설정 파일의 mcpServers에 아래와 같이 등록합니다 (경로는 실제 설치 위치로 교체). npx가 아니라 node로 직접 실행해야 Windows에서 안정적으로 동작합니다.

{
  "mcpServers": {
    "classby-blog-mcp": {
      "command": "node",
      "args": ["/absolute/path/to/.classby-blog-mcp/node_modules/classby-blog-mcp/dist/server.mjs"],
      "env": {
        "STUDIOB_GATE_URL": "https://tool.classby.kr",
        "STUDIOB_KEY": "<설치 키>"
      }
    }
  }
}

라이선스 게이트 (STUDIOB_GATE_URL / STUDIOB_KEY)

src/lib/gate.mjs에 호출 구조만 만들어 두었습니다. 실제 엔드포인트 경로, 요청/응답 필드, 실패 시 정책(도구 차단 여부 등)이 정해지면 해당 파일의 TODO 부분만 채우면 됩니다. 현재는 값이 없거나 호출이 실패해도 서버 기동을 막지 않습니다.

알려진 제약

• naver_fill_editor의 선택자는 네이버 스마트에디터 ONE 기준 추정치이며, 에디터 업데이트에 따라 조정이 필요할 수 있습니다.
• 글 발행(공개)은 자동화하지 않습니다 — 사용자가 직접 최종 확인 후 발행해야 합니다.