Skip to main content
Glama

Blog Generator MCP

AI를 활용한 기술 블로그 자동 생성 MCP 서버입니다.


빠른 시작

1. 설치

npx blog-generator-mcp

2. API 키 준비

3. Claude Desktop 설정

~/.config/claude/claude_desktop_config.json:

{
  "mcpServers": {
    "blog-generator": {
      "command": "npx",
      "args": ["-y", "blog-generator-mcp"],
      "env": {
        "GEMINI_API_KEY": "your-gemini-api-key",
        "BLOG_SAVE_DIRECTORY": "./posts"
      }
    }
  }
}

환경변수 설명:

환경변수

필수

설명

GEMINI_API_KEY

O

Gemini API 키

BLOG_SAVE_DIRECTORY

X

블로그 저장 경로 (기본: ./posts)

Claude Desktop을 재시작하면 사용 준비 완료!


Related MCP server: @alog-world/mcp

사용법

기본 워크플로우

1. blog_start_draft    → 초안 생성 시작
2. blog_get_status     → 완료 확인
3. blog_apply_feedback → (선택) 피드백 반영
4. blog_start_review   → 검수 시작
5. blog_save           → 파일 저장

Pro Mode 워크플로우 (v4.1)

환경에 따라 다른 방식으로 고품질 블로그 생성:

Claude Desktop/Code 환경:

Claude에게 직접 요청 → Claude가 코드 분석 + 블로그 작성 → blog_save

HTTP 모드 (서버 배포):

1. blog_start_draft_pro → Gemini 분석 → Claude API 작성
2. blog_get_status      → 완료 확인
3. blog_apply_feedback_pro → (선택) 피드백 반영
4. blog_save            → 파일 저장

Pro Mode (v4.1)

Claude Desktop/Code 환경

Claude Desktop이나 Claude Code를 사용 중이라면 별도의 Pro Mode 도구가 필요 없습니다. 대화 중인 Claude에게 직접 요청하세요:

User: "이 코드로 블로그 써줘"
User: "<git diff 내용 붙여넣기>"

→ Claude가 직접 코드를 분석하고 블로그를 작성합니다.
→ blog_save로 저장하면 끝!

장점:

  • API 키 불필요 (Gemini, Anthropic 둘 다)

  • 대화 맥락을 활용한 자연스러운 글쓰기

  • 실시간 피드백 반영

HTTP 모드 (서버 배포)

HTTP 서버로 배포하여 여러 사용자가 사용할 때는 Pro Mode 도구를 사용합니다.

아키텍처:

┌─────────────────────────────────────────────────────────────┐
│                    blog_start_draft_pro                      │
│  ┌─────────────────┐         ┌─────────────────┐           │
│  │ Gemini Pro      │ ──────> │ Claude API      │           │
│  │ (Researcher)    │ 분석결과 │ (Writer)        │           │
│  │                 │         │                 │           │
│  │ - code_diff     │         │ - 분석 기반     │           │
│  │ - dev_log 분석  │         │ - 서사적 글쓰기 │           │
│  │ - 아키텍처 해석 │         │ - 인사이트 도출 │           │
│  └─────────────────┘         └─────────────────┘           │
└─────────────────────────────────────────────────────────────┘

blog_start_draft_pro - Pro 초안 생성 (HTTP 모드 전용)

필수 파라미터:

{
  "code_diff": "git diff 또는 변경된 코드"
}

선택 파라미터:

파라미터

설명

기본값

dev_log

개발자의 고민/메모/의사결정 과정

-

request

최우선 제약조건 (이 요청을 최우선으로 반영)

-

style

글 스타일

deep-dive

language

언어

ko

instructions

상세 작성 지침

-

gemini_api_key

Gemini API 키 (환경변수로 대체 가능)

-

anthropic_api_key

Anthropic API 키 (환경변수로 대체 가능)

-

blog_apply_feedback_pro - Pro 피드백 반영 (HTTP 모드 전용)

파라미터:

{
  "task_id": "Pro 작업 ID",
  "feedback": "수정 요청 사항"
}

HTTP 모드 환경 설정

HTTP 모드에서 Pro Mode를 사용하려면 Anthropic API 키가 필요합니다:

{
  "mcpServers": {
    "blog-generator": {
      "command": "npx",
      "args": ["-y", "blog-generator-mcp", "--http", "--port", "3000"],
      "env": {
        "GEMINI_API_KEY": "your-gemini-api-key",
        "ANTHROPIC_API_KEY": "your-anthropic-api-key",
        "BLOG_SAVE_DIRECTORY": "./posts"
      }
    }
  }
}

Pro Mode 사용 예시 (HTTP 모드)

1. blog_start_draft_pro
   - code_diff: "<git diff 내용>"
   - dev_log: "기존 세션 기반에서 JWT로 전환. 보안 강화가 목표..."
   - request: "보안 관점에서 왜 이 방식을 선택했는지 강조"

2. blog_get_status (완료 확인)

3. blog_apply_feedback_pro (선택)
   - feedback: "코드 예제에 주석을 더 추가해줘"

4. blog_save
   - directory: "./posts"

도구 상세 가이드

blog_start_draft - 초안 생성

필수 파라미터:

{
  "input_type": "keyword",
  "content": "React useEffect 훅 사용법",
  "gemini_api_key": "YOUR_API_KEY"
}

선택 파라미터:

파라미터

설명

기본값

style

글 스타일

tutorial

language

언어

ko

model

Gemini 모델

gemini-1.5-flash

instructions

상세 작성 지침

-

custom_prompt

간단한 추가 요청

-

입력 유형 (input_type):

값

용도

예시

keyword

키워드로 글 생성

"React hooks"

code

코드 설명 글

코드 스니펫

memo

메모를 글로 확장

불릿포인트 메모

git_push

개발일지 생성

git diff 내용

글 스타일 (style):

값

설명

tutorial

단계별 튜토리얼

til

Today I Learned

deep-dive

심층 분석

troubleshooting

문제 해결 과정

사용 예시:

"React hooks에 대한 튜토리얼을 작성해줘"

→ blog_start_draft 호출:
  - input_type: "keyword"
  - content: "React hooks"
  - style: "tutorial"
  - gemini_api_key: "YOUR_KEY"

blog_get_status - 상태 확인

파라미터:

{
  "task_id": "작업 ID"
}

응답 예시:

{
  "task_id": "abc-123",
  "status": "completed",
  "progress": 100,
  "result": {
    "draft": "# React Hooks 완벽 가이드\n...",
    "metadata": {
      "title": "React Hooks 완벽 가이드",
      "tags": ["React", "Hooks", "JavaScript"],
      "estimatedReadTime": "10분"
    }
  }
}

상태 값:

상태

설명

pending

대기 중

in_progress

진행 중

completed

완료

failed

실패


blog_apply_feedback - 피드백 반영

파라미터:

{
  "task_id": "작업 ID",
  "feedback": "코드 예제를 더 추가해주세요",
  "gemini_api_key": "YOUR_KEY"
}

사용 예시:

"코드 예제를 더 추가하고, 초보자도 이해할 수 있게 설명을 보충해줘"

→ blog_apply_feedback 호출:
  - task_id: "이전 작업 ID"
  - feedback: "코드 예제를 더 추가하고, 초보자도 이해할 수 있게 설명을 보충해주세요"

blog_start_review - 검수

파라미터:

{
  "task_id": "초안 작업 ID",
  "focus": "all",
  "gemini_api_key": "YOUR_KEY"
}

검수 초점 (focus):

값

설명

accuracy

기술적 정확성

readability

가독성

seo

SEO 최적화

all

전체 검수 (기본값)


blog_save - 파일 저장

파라미터:

{
  "task_id": "작업 ID",
  "directory": "./posts"
}

결과:

{
  "filepath": "./posts/2024-01-15-react-hooks-완벽-가이드.md"
}

blog_deploy_github - GitHub 배포

파라미터:

{
  "task_id": "작업 ID",
  "repo": "username/blog",
  "target_path": "_posts/2024-01-15-react-hooks.md",
  "github_token": "YOUR_GITHUB_TOKEN"
}

상세 지침 (instructions) 활용하기

instructions 파라미터 또는 instructions_file로 마크다운 파일 경로를 지정하여 AI가 따라야 할 상세한 작성 규칙을 지정할 수 있습니다.

파일로 관리하기

blog_start_draft 호출:
- input_type: "keyword"
- content: "Kubernetes 배포 전략"
- instructions_file: "./my-style-guide.md"

둘 다 제공하면 병합됩니다:

- instructions_file: "./my-style-guide.md"  // 기본 스타일 가이드
- instructions: "이번 글은 특히 보안에 집중해줘"  // 추가 요청

→ 파일 내용 + 파라미터 내용이 합쳐져서 적용됩니다.

예시: 회사 블로그 스타일 가이드

blog_start_draft 호출:
- input_type: "keyword"
- content: "Kubernetes 배포 전략"
- instructions: |
    ## 작성 스타일
    - 경어체 사용 (~합니다, ~입니다)
    - 문장은 짧고 명확하게
    - 한 단락은 3-4문장 이내

    ## 필수 포함 섹션
    1. 개요 (왜 이 주제가 중요한지)
    2. 핵심 개념 설명
    3. 실습 예제 (복사해서 바로 실행 가능)
    4. 주의사항 및 팁
    5. 마무리 및 다음 단계

    ## 코드 스타일
    - 모든 코드 블록에 언어 명시
    - 주석은 한국어로
    - 실제 동작하는 완전한 예제 제공

    ## 타겟 독자
    - 백엔드 개발 경력 1-3년차
    - Docker 기본 지식 보유
    - Kubernetes 입문자

    ## 금지 사항
    - "쉽습니다", "간단합니다" 등의 표현 금지
    - 불필요한 영어 표현 자제

예시: TIL 스타일

instructions: |
    ## 형식
    - 날짜와 제목으로 시작
    - 배운 내용을 불릿포인트로 정리
    - 실제 코드나 명령어 포함

    ## 톤
    - 개인적이고 솔직한 톤
    - 시행착오 과정도 포함
    - 다음에 더 알아볼 것 메모

모델 선택 가이드

모델

용도

특징

gemini-1.5-flash

일반 용도 (기본값)

빠른 응답, 비용 효율적

gemini-1.5-flash-8b

간단한 작업

가장 빠름

gemini-1.5-pro

고품질 필요 시

복잡한 주제, 긴 글

gemini-2.0-flash

최신 기능

최신 모델

추천:

  • 일반 블로그 글: gemini-1.5-flash

  • 기술 심층 분석: gemini-1.5-pro

  • 짧은 TIL: gemini-1.5-flash-8b


실전 예시

예시 1: 튜토리얼 작성

User: "Next.js App Router에 대한 튜토리얼을 작성해줘"

1. blog_start_draft
   - input_type: "keyword"
   - content: "Next.js App Router"
   - style: "tutorial"
   - model: "gemini-1.5-pro"
   - gemini_api_key: "..."

2. blog_get_status (완료 확인)

3. blog_apply_feedback
   - feedback: "서버 컴포넌트와 클라이언트 컴포넌트 차이를 더 자세히 설명해줘"

4. blog_start_review
   - focus: "accuracy"

5. blog_save
   - directory: "./content/posts"

예시 2: 개발일지 자동 생성

User: "오늘 커밋 내용으로 개발일지 써줘"

1. blog_start_draft
   - input_type: "git_push"
   - content: "<git diff 또는 commit log>
   - style: "til"
   - gemini_api_key: "..."

2. blog_get_status → blog_save

예시 3: 코드 설명 블로그

User: "이 코드를 설명하는 블로그 글을 작성해줘"

1. blog_start_draft
   - input_type: "code"
   - content: "<코드 내용>"
   - style: "deep-dive"
   - instructions: "코드의 동작 원리를 시각적으로 설명하고, 성능 관점에서 분석해줘"

HTTP 서버 모드

여러 사용자가 공유하는 서버로 배포할 수 있습니다.

# HTTP 서버 시작
npx blog-generator-mcp --http --port 3000

# 헬스 체크
curl http://localhost:3000/health

# MCP 요청
curl -X POST http://localhost:3000/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/list","id":1}'

문제 해결

"Gemini API 키가 필요합니다"

→ gemini_api_key 파라미터에 API 키를 전달했는지 확인

"작업을 찾을 수 없습니다"

→ task_id가 올바른지 확인. 서버 재시작 시 이전 작업은 유지됨

"모델을 찾을 수 없습니다"

→ 지원되는 모델명 확인: gemini-1.5-flash, gemini-1.5-pro 등

응답이 느림

→ gemini-1.5-flash 대신 gemini-1.5-flash-8b 사용


라이선스

MIT

Available Tools

10 tools
blog_apply_feedbackApply Feedback to DraftA

사용자 피드백을 초안에 반영합니다 (백그라운드 실행).

피드백 히스토리가 저장되어 이전 피드백들을 추적할 수 있습니다.

모델 선택 (model)

  • gemini-1.5-flash: 빠른 응답 (기본값)

  • gemini-1.5-pro: 고품질 피드백 반영

Args:

  • task_id: 피드백을 적용할 작업 ID

  • feedback: 수정 요청 사항

  • model: Gemini 모델 (기본: gemini-1.5-flash)

  • gemini_api_key: Gemini API 키 (없으면 GEMINI_API_KEY 환경변수 사용)

Returns:

  • task_id: 작업 ID

  • status: "pending"

  • message: 안내 메시지

Inputs: task_id (required), feedback (required), model, gemini_api_key. Returns: model, status, message, task_id

blog_apply_feedback_proApply Feedback to Pro DraftA

[HTTP 모드 전용] Pro Mode로 생성된 블로그 초안에 피드백을 반영합니다.

⚠️ Claude Desktop/Code 사용자: 이 도구는 HTTP 모드에서만 필요합니다. Claude Desktop/Code 환경에서는 Claude에게 직접 수정을 요청하세요.

Args:

  • task_id: Pro 작업 ID (필수)

  • feedback: 수정 요청 사항 (필수)

  • anthropic_api_key: Anthropic API 키 (환경변수로 대체 가능)

Returns:

  • task_id: 작업 ID

  • status: 작업 상태

Inputs: task_id (required), feedback (required), anthropic_api_key. Returns: status, message, task_id

blog_apply_review_feedbackApply Review FeedbackA

검수 결과에 추가 피드백을 반영합니다 (백그라운드 실행).

모델 선택 (model)

  • gemini-1.5-flash: 빠른 응답 (기본값)

  • gemini-1.5-pro: 고품질 피드백 반영

Args:

  • task_id: 피드백을 적용할 검수 작업 ID

  • feedback: 추가 검수 요청 사항

  • model: Gemini 모델 (기본: gemini-1.5-flash)

  • gemini_api_key: Gemini API 키 (없으면 GEMINI_API_KEY 환경변수 사용)

Returns:

  • task_id: 작업 ID

  • status: "pending"

  • message: 안내 메시지

Inputs: task_id (required), feedback (required), model, gemini_api_key. Returns: model, status, message, task_id

blog_deploy_githubDeploy to GitHubA
Idempotent

블로그 글을 GitHub 저장소에 배포합니다.

기존 작업 ID, 직접 콘텐츠 입력, 또는 로컬 파일 경로를 사용할 수 있습니다. Jekyll, Hugo 등의 정적 사이트 생성기를 사용하는 블로그에 직접 커밋합니다.

Args:

  • task_id: 배포할 작업 ID (선택)

  • content: 직접 배포할 마크다운 콘텐츠 (선택)

  • filepath: 배포할 로컬 파일 경로 (선택)

  • repo: GitHub 저장소 (owner/repo 형식, 필수)

  • branch: 배포할 브랜치 (기본: main)

  • target_path: 저장소 내 저장 경로 (필수)

  • commit_message: 커밋 메시지 (선택)

  • github_token: GitHub Personal Access Token (필수)

Returns:

  • url: 커밋 URL

  • deployed: 배포 성공 여부

  • message: 안내 메시지

Inputs: no named parameters. Returns: url, message, deployed

blog_finalize_draftFinalize Blog DraftA
Read-onlyIdempotent

블로그 초안을 확정합니다.

완료된 작업의 최종 결과를 반환합니다. 이후 blog_save 또는 blog_deploy_github로 저장/배포할 수 있습니다.

Args:

  • task_id: 확정할 작업 ID

Returns:

  • draft: 최종 확정된 초안

  • metadata: { title, tags, estimatedReadTime }

  • message: 안내 메시지

Inputs: task_id (required). Returns: draft, message, metadata

blog_get_statusGet Task StatusA
Read-onlyIdempotent

작업 상태를 조회합니다.

Args:

  • task_id: 조회할 작업 ID

Returns:

  • task_id: 작업 ID

  • status: pending | in_progress | completed | failed

  • progress: 진행률 (0-100)

  • result: 완료 시 결과 (draft, metadata 등)

  • error: 실패 시 오류 메시지

Inputs: task_id (required). Returns: error, result, status, task_id, +1 more

blog_saveSave Blog PostA
Idempotent

블로그 글을 로컬 마크다운 파일로 저장합니다.

기존 작업 ID를 사용하거나 직접 콘텐츠를 입력할 수 있습니다. 파일명이 제공되지 않으면 글 제목과 날짜를 기반으로 자동 생성합니다.

Args:

  • task_id: 저장할 작업 ID (선택)

  • content: 직접 저장할 마크다운 콘텐츠 (선택)

  • filename: 파일명 (선택, 없으면 자동 생성)

  • directory: 저장 디렉토리 경로 (없으면 BLOG_SAVE_DIRECTORY 환경변수 또는 ./posts)

Returns:

  • filepath: 저장된 파일의 전체 경로

  • message: 안내 메시지

Inputs: no named parameters. Returns: message, filepath

blog_start_draftStart Blog Draft GenerationA

블로그 초안 생성을 시작합니다 (백그라운드 실행).

입력 유형 (input_type)

  • keyword: 키워드/주제로 글 생성

  • code: 코드 스니펫을 설명하는 글 생성

  • memo: 메모/노트를 완성된 글로 확장

  • git_push: git 변경사항으로 개발일지 생성

  • notion: Notion 페이지 URL을 입력하면 내용을 자동으로 가져와서 블로그 글 생성 (content에 Notion URL 입력, notion_api_key 필요)

글 스타일 (style)

  • tutorial: 단계별 튜토리얼 (기본값)

  • til: Today I Learned 형식

  • deep-dive: 심층 기술 분석

  • troubleshooting: 문제 해결 과정

모델 선택 (model)

  • gemini-1.5-flash: 빠른 응답, 일반 용도 (기본값)

  • gemini-1.5-flash-8b: 더 빠른 응답, 간단한 작업

  • gemini-1.5-pro: 고품질, 복잡한 작업

  • gemini-2.0-flash: 최신 모델

상세 지침 (instructions / instructions_file)

skill.md 스타일로 상세한 작성 지침을 제공할 수 있습니다:

  • 글의 톤과 문체

  • 반드시 포함할 섹션

  • 타겟 독자층

  • 예시 스타일 참조

  • 금지 표현

  • 코드 스타일 가이드 등을 상세히 기술하면 모델이 지침을 따릅니다.

instructions_file로 마크다운 파일 경로를 지정하면 파일에서 지침을 읽어옵니다. 둘 다 제공하면 파일 내용 + 파라미터 내용이 병합됩니다.

Args:

  • input_type: 입력 유형

  • content: 블로그 글 생성에 사용할 입력 내용

  • style: 글 스타일 (기본: tutorial)

  • language: 출력 언어 ko/en (기본: ko)

  • model: Gemini 모델 (기본: gemini-1.5-flash)

  • instructions: 상세 작성 지침 (선택)

  • instructions_file: 상세 작성 지침 마크다운 파일 경로 (선택)

  • custom_prompt: 간단한 추가 요청 (선택)

  • gemini_api_key: Gemini API 키 (없으면 GEMINI_API_KEY 환경변수 사용)

  • notion_api_key: Notion API 키 (input_type이 notion일 때 필요, 없으면 NOTION_API_KEY 환경변수 사용)

  • web_search: 웹 검색 활용 여부 (기본: false). true로 설정하면 최신 정보, 통계, 참고 자료를 웹에서 검색하여 포함

Returns:

  • task_id: 작업 추적용 ID

  • status: "pending"

  • message: 안내 메시지

Inputs: content (required), input_type (required), model, style, +7 more. Returns: model, status, message, task_id

blog_start_draft_proStart Pro Blog Draft GenerationA

[HTTP 모드 전용] Claude Opus(분석 + 작성) 파이프라인으로 고품질 블로그 생성을 시작합니다.

⚠️ Claude Desktop/Code 사용자: 이 도구는 HTTP 모드에서만 필요합니다. Claude Desktop/Code 환경에서는 Claude에게 직접 "이 코드로 블로그 써줘"라고 요청하세요. Claude가 직접 코드를 분석하고 블로그를 작성합니다.

작동 방식 (HTTP 모드)

  1. Claude Opus가 코드를 분석하여 인사이트 추출

  2. Claude Opus가 분석 결과를 바탕으로 블로그 작성

  3. blog_get_status로 완료 확인

Args:

  • code_diff: Git diff 또는 변경된 코드 (필수)

  • dev_log: 개발자의 고민/메모/의사결정 과정 (선택)

  • request: 최우선 제약조건 (선택)

  • style: 글 스타일 (기본: deep-dive)

  • language: 언어 (기본: ko)

  • instructions: 상세 작성 지침 (선택)

  • instructions_file: 상세 작성 지침 마크다운 파일 경로 (선택, instructions와 병합 가능)

  • anthropic_api_key: Anthropic API 키 (환경변수로 대체 가능)

  • web_search: 웹 검색 활용 여부 (기본: true). 최신 정보, 이미지, 참고 자료를 웹에서 검색하여 포함

Returns:

  • task_id: 작업 추적용 ID

  • status: 작업 상태

Inputs: code_diff (required), style, dev_log, request, +5 more. Returns: status, message, task_id

blog_start_reviewStart Blog ReviewA

블로그 글 검수를 시작합니다 (백그라운드 실행).

기존 작업 ID를 사용하거나 직접 초안을 입력할 수 있습니다.

검수 초점 (focus)

  • accuracy: 기술적 정확성

  • readability: 가독성

  • seo: SEO 최적화

  • all: 전체 검수 (기본값)

모델 선택 (model)

  • gemini-1.5-flash: 빠른 검수 (기본값)

  • gemini-1.5-pro: 심층 검수

상세 검수 지침 (instructions / instructions_file)

검수 기준을 상세히 지정할 수 있습니다:

  • 회사/팀 스타일 가이드

  • 용어 사용 규칙

  • 코드 컨벤션

  • 타겟 독자 수준

  • 금지 표현 등을 명시하면 해당 기준으로 검수합니다.

instructions_file로 마크다운 파일 경로를 지정하면 파일에서 지침을 읽어옵니다. 둘 다 제공하면 파일 내용 + 파라미터 내용이 병합됩니다.

Args:

  • task_id: 기존 작업 ID (선택)

  • draft: 직접 입력할 초안 내용 (선택)

  • focus: 검수 초점 (기본: all)

  • model: Gemini 모델 (기본: gemini-1.5-flash)

  • instructions: 상세 검수 지침 (선택)

  • instructions_file: 상세 검수 지침 마크다운 파일 경로 (선택)

  • custom_prompt: 간단한 추가 검수 요청 (선택)

  • gemini_api_key: Gemini API 키 (없으면 GEMINI_API_KEY 환경변수 사용)

Returns:

  • task_id: 검수 작업 ID

  • status: "pending"

  • message: 안내 메시지

Inputs: no named parameters. Returns: model, status, message, task_id

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.1/5.0

    Scored across 10 tools

    Disambiguation4/5

    Most tools have clearly distinct roles: generation, status tracking, feedback, review, saving, and deployment. The main ambiguity is between standard and 'pro' variants (start_draft vs start_draft_pro, apply_feedback vs apply_feedback_pro), but they are explicitly separated by mode and input requirements.

    Naming Consistency4/5

    All tools share the 'blog_' prefix and mostly follow a verb_noun pattern (start_draft, apply_feedback, get_status). Minor deviations like blog_save and blog_deploy_github omit the object or use a platform target, but the pattern remains predictable.

    Tool Count5/5

    With 10 tools, the server is well-scoped for its purpose. Each tool maps to a distinct stage in the blog lifecycle, and the count is appropriate for a specialized generator.

    Completeness5/5

    The tool surface covers the full workflow: create draft, check status, apply feedback, finalize, review, apply review feedback, save locally, and deploy to GitHub. No critical operations are missing for the stated purpose.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers