blog-generator-mcp

Blog Generator MCP

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

---

빠른 시작

1. 설치

npx blog-generator-mcp

2. API 키 준비

• Gemini API 키: Google AI Studio에서 발급

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을 재시작하면 사용 준비 완료!

---

사용법

기본 워크플로우

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 모드 전용)

필수 파라미터: ``json { "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 모드 전용)

파라미터: ``json { "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 - 초안 생성

필수 파라미터: ``json { "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" } ```

응답 예시: ``json { "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 - 피드백 반영

파라미터: ``json { "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 - 파일 저장

파라미터: ``json { "task_id": "작업 ID", "directory": "./posts" } ``

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

---

blog_deploy_github - GitHub 배포

파라미터: ``json { "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: "..."

1. blog_get_status (완료 확인)

1. blog_apply_feedback

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

1. blog_start_review

• focus: "accuracy"

1. 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: "..."

1. 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