blog-writer-mcp

AI 블로그 자동화 MCP 서버
당신이 사랑한 것들에서 당신만의 목소리를 찾아드립니다

AI Blog Automation MCP Server
We find your voice in the things you love

---

The 4th Path: ⟨H⊕A⟩ ↦ Ω

Human (H) and AI (A), not as tools and users — but as partners moving toward something better (Ω).

This is how 22B Labs builds. Everything free, everything open. → the4thpath.com

22B Labs | the4thpath.com MIT License

---

목차 / Table of Contents

• 이게 뭔가요?
• 창작 DNA란?
• 주요 기능
• 설치 방법
• Claude Desktop 연결
• ChatGPT 연결
• 사용 방법
• 도구 목록
• 프로젝트 구조
• FAQ

---

이게 뭔가요? / What is this?

blog-writer-mcp는 Claude나 ChatGPT에 직접 연결해서 쓰는 블로그 자동화 도구입니다.

blog-writer-mcp is a blog automation tool that connects directly to Claude or ChatGPT.

기존 블로그 자동화 도구와 뭐가 다른가요?

	기존 도구	blog-writer-mcp
글쓰기 기반	당신이 쓴 글을 학습	당신이 사랑한 것들을 학습
대상	글을 쓸 수 있는 사람	글을 못 써도 OK
인터페이스	별도 웹 UI 필요	Claude / ChatGPT 대화창
개인화 방식	문체 모방	세계관·감수성 반영
가격	월정액 유료	완전 무료

How is this different from other blog tools?

	Other tools	blog-writer-mcp
Writing basis	Learns from your past writing	Learns from what you love
Target users	People who can write	Anyone, even non-writers
Interface	Separate web UI	Claude / ChatGPT chat
Personalization	Style mimicking	Worldview & sensibility
Price	Monthly subscription	Completely free

---

창작 DNA란? / What is Creative DNA?

대부분의 AI 글쓰기 도구는 "당신이 쓴 글을 업로드하면 그 스타일로 써드립니다"라고 합니다. 그런데 글을 못 쓰기 때문에 도움받으러 온 사람에게는 소용이 없습니다.

Most AI writing tools say "upload your past writing and we'll match your style." But that's useless for people who came for help precisely because they can't write.

창작 DNA는 다릅니다. 당신이 감동받은 것들에서 당신의 세계관을 추출합니다.

Creative DNA is different. It extracts your worldview from the things that moved you.

좋아하는 작가  →  문체의 깊이와 호흡
좋아하는 책    →  주제의식과 인생관
좋아하는 영화  →  감정의 결과 스케일
좋아하는 애니  →  가치관과 전달 방식

Favorite authors  →  Depth and rhythm of writing
Favorite books    →  Themes and life philosophy
Favorite films    →  Emotional register and scale
Favorite anime    →  Values and how they're conveyed

예를 들어 / For example:

파울로 코엘료 + 그리스인 조르바 + 인터스텔라 + 지브리

Paulo Coelho + Zorba the Greek + Interstellar + Ghibli

이 조합에서 시스템은 다음을 추출합니다:

From this combination, the system extracts:

• 테마: 자유, 여정, 우주적 연결, 삶의 긍정
• 문체: 단순한 문장 안에 깊은 진리 / Simple sentences carrying deep truths
• 금지 톤: 설교적, 냉소적, 기계적 / Preachy, cynical, mechanical

그 결과, AI가 쓴 글인데 당신이 쓴 것처럼 느껴집니다.

The result: AI-written content that feels like you wrote it.

---

주요 기능 / Features

창작 DNA 시스템 / Creative DNA System

• 좋아하는 작가·책·영화에서 글쓰기 세계관 자동 추출
• Automatically extracts writing worldview from favorite authors, books, films
• 한 번 설정하면 이후 모든 글에 자동 적용
• Set once, applied to all future writing

AI 글쓰기 / AI Writing

• 트렌드 수집 → 주제 선정 → 글 작성 → 발행 전 과정 자동화
• Full pipeline: trend collection → topic selection → writing → publishing
• Google Blogger 자동 발행 / Auto-publish to Google Blogger
• 이미지 자동 생성 첨부 / Auto-generate and attach images

SEO + GEO 최적화 / SEO + GEO Optimization

• 메타 태그, 헤딩 구조, 키워드 밀도 자동 최적화
• Auto-optimize meta tags, heading structure, keyword density
• GEO (Generative Engine Optimization): ChatGPT·Claude·Perplexity 인용 최적화
• GEO: Optimize for citations in AI search engines

성과 피드백 루프 / Performance Feedback Loop

• Google Search Console 연동으로 실제 트래픽 분석
• Analyze real traffic via Google Search Console
• 성과 좋은 글 패턴 → 다음 주제 추천 자동화
• High-performing patterns → automated next topic recommendations

쿠팡 파트너스 자동 링크 / Auto Affiliate Links

• 글 내용에 맞는 쿠팡 링크 자동 삽입
• Automatically insert relevant Coupang affiliate links

---

설치 방법 / Installation

사전 요구사항 / Prerequisites

• Python 3.11 이상 / Python 3.11 or higher
• Node.js 18 이상 (프론트엔드 빌드용) / Node.js 18+ (for frontend build)
• Claude Desktop 또는 ChatGPT Plus/Pro 계정
• Claude Desktop or ChatGPT Plus/Pro account
• Google Blogger 블로그 또는 WordPress 사이트 / Google Blogger blog or WordPress site

1단계 — 코드 다운로드 / Step 1 — Download

git clone https://github.com/sinmb79/blog-writer_mcp.git
cd blog-writer_mcp

2단계 — 환경 설정 / Step 2 — Environment Setup

# Windows
scripts\setup.bat

# Mac/Linux
pip install -e .

setup.bat이 자동으로 / setup.bat automatically:

• Python 가상환경 생성 / Creates Python virtual environment
• 패키지 설치 / Installs packages
• 필요한 디렉토리 생성 / Creates required directories
• 한글 폰트 다운로드 / Downloads Korean fonts

3단계 — API 키 설정 / Step 3 — API Keys

copy .env.example .env

.env 파일을 열어서 아래 값을 입력합니다 / Open .env and fill in:

# Google Blogger 인증 / Google Blogger Auth
GOOGLE_CLIENT_ID=your_client_id
GOOGLE_CLIENT_SECRET=your_client_secret
# 아래 명령어 실행 후 자동 입력됨
# Run the command below and this will be auto-filled:
# python scripts/get_token.py
GOOGLE_REFRESH_TOKEN=

# 블로그 ID (Blogger URL에서 확인) / Blog ID (found in Blogger URL)
BLOG_MAIN_ID=your_18_digit_blog_id

# WordPress Application Password 인증 (선택) / WordPress Application Password auth (optional)
WP_URL=https://your-site.com
WP_USERNAME=your_username
WP_APP_PASSWORD=xxxx xxxx xxxx xxxx xxxx xxxx

# Telegram 알림 (선택) / Telegram notifications (optional)
TELEGRAM_BOT_TOKEN=
TELEGRAM_CHAT_ID=

# 쿠팡 파트너스 (선택) / Coupang Partners (optional)
COUPANG_ACCESS_KEY=
COUPANG_SECRET_KEY=

4단계 — Google 인증 / Step 4 — Google Authentication

python scripts/get_token.py

브라우저가 열리면 Google 계정으로 로그인 → 자동으로 token.json 저장됩니다.

A browser will open. Log in with your Google account → token.json is saved automatically.

5단계 — MCP 서버 실행 / Step 5 — Start MCP Server

python -m blogwriter_mcp.server

http://127.0.0.1:8766/mcp 에서 서버가 실행됩니다.

Server runs at http://127.0.0.1:8766/mcp.

---

Claude Desktop 연결 / Claude Desktop Setup

Claude Desktop이란? / What is Claude Desktop?

Anthropic이 만든 AI 앱입니다. claude.ai/download에서 무료로 다운로드할 수 있습니다. MCP 서버를 연결하면 Claude가 직접 블로그 도구를 사용할 수 있습니다.

Claude Desktop is an AI app by Anthropic. Download free at claude.ai/download. Connect an MCP server and Claude can directly use blog tools.

설정 방법 / Setup

설정 파일 위치 / Config file location:

• Windows: %APPDATA%\Claude\claude_desktop_config.json
• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

파일을 열어 아래 내용을 추가합니다 / Open the file and add:

{
  "mcpServers": {
    "blog_writer": {
      "command": "mcp-remote",
      "args": ["http://127.0.0.1:8766/mcp"]
    }
  }
}

Claude Desktop을 재시작합니다 / Restart Claude Desktop.

입력창 하단에 도구 아이콘이 생기면 연결 성공입니다.

If you see a tools icon at the bottom of the input box, the connection is successful.

---

ChatGPT 연결 / ChatGPT Setup

필요 조건 / Requirements: ChatGPT Plus, Pro, Team, 또는 Enterprise 구독 ChatGPT Plus, Pro, Team, or Enterprise subscription required

ChatGPT는 localhost에 직접 접속할 수 없어서 터널링이 필요합니다.

ChatGPT cannot access localhost directly, so tunneling is required.

1단계 — ngrok 설치 / Step 1 — Install ngrok

ngrok.com에서 무료 계정 생성 후 설치합니다.

Create a free account at ngrok.com and install.

ngrok http 8766

https://abc123.ngrok.app 같은 주소가 생성됩니다.

A URL like https://abc123.ngrok.app will be generated.

2단계 — ChatGPT Connector 등록 / Step 2 — Register ChatGPT Connector

1. ChatGPT 설정 열기 / Open ChatGPT Settings
2. Connectors → Developer Mode 활성화 / Enable Developer Mode
3. Create 클릭 / Click Create
4. 아래와 같이 입력 / Fill in:

Connector name:  blog-writer-mcp
Description:     AI 블로그 자동화. 창작 DNA로 당신만의 목소리로 씁니다.
                 AI blog automation. Write in your own voice with Creative DNA.
Connector URL:   https://abc123.ngrok.app/mcp

URL이 바뀌면 Connector를 업데이트해야 합니다. Update the Connector when the tunnel URL changes.

---

사용 방법 / How to Use

처음 시작하기 — 창작 DNA 설정 / Getting Started — Set Your Creative DNA

Claude Desktop이나 ChatGPT에서 이렇게 말하세요 / Say this in Claude Desktop or ChatGPT:

내 창작 DNA를 설정해줘.

좋아하는 작가: 파울로 코엘료
좋아하는 책: 그리스인 조르바
좋아하는 영화: 인터스텔라
좋아하는 애니: 지브리 스타일 (자연, 교훈, 경이로움)
나의 키워드: 자유, 여정, 인간과 기술의 공존

---

Set my creative DNA.

Favorite author: Paulo Coelho
Favorite book: Zorba the Greek
Favorite film: Interstellar
Favorite anime style: Ghibli (nature, lessons, wonder)
My keywords: freedom, journey, human-technology coexistence

시스템이 취향을 분석해서 당신만의 글쓰기 세계관을 추출합니다. 한 번 설정하면 끝입니다.

The system analyzes your preferences and extracts your unique writing worldview. Set it once and you're done.

---

글 쓰기 / Write an Article

오늘 AI 관련 트렌드 하나 골라서 블로그 글 써줘.
내 DNA 스타일로.

---

Pick one AI trend today and write a blog post.
Apply my DNA style.

Claude가 알아서 다음 흐름을 수행할 수 있습니다:

1. 트렌드 수집 (blog_get_trending)
2. 주제 선정 및 글 작성 (blog_write_article)
3. SEO 최적화 (blog_optimize_seo)
4. 이미지 생성 (blog_generate_image)
5. 쿠팡 링크 삽입 (blog_insert_affiliate_links)
6. 발행 (blog_publish, platform="blogger" | "wordpress" | "both")

---

성과 확인 / Check Performance

최근 한 달 블로그 성과 보여줘. 다음에 뭘 쓰면 좋을지 추천도 해줘.

---

Show me last month's blog performance. Recommend what to write next.

---

전체 파이프라인 한 번에 / Full Pipeline at Once

"AI와 인간의 미래" 주제로 전체 파이프라인 돌려줘.

---

Run the full pipeline on the topic "The future of AI and humanity."

---

도구 목록 / Tools

도구 이름 / Tool Name	설명 / Description	기반 / Based on
blog_get_trending	트렌드 수집 / Collect trends	collector_bot.py
blog_write_article	글 작성 (DNA 적용) / Write article (with DNA)	writer_bot.py
blog_generate_image	이미지 생성 / Generate image	image_bot.py
blog_optimize_seo	SEO + GEO 최적화 / SEO + GEO optimization	article_parser.py + seo_optimizer.py
blog_insert_affiliate_links	쿠팡 링크 삽입 / Insert affiliate links	linker_bot.py
blog_publish	Blogger / WordPress 발행 / Publish to Blogger or WordPress	publisher_bot.py + wp_publisher_bot.py
blog_get_analytics	성과 분석 / Performance analytics	analytics_bot.py
blog_full_pipeline	전체 자동화 / Full automation	assist_bot.py + server.py
blog_set_creative_dna	창작 DNA 설정 / Set Creative DNA	creative_dna.py
blog_get_performance_feedback	성과 피드백 / Performance feedback	performance_feedback.py

---

프로젝트 구조 / Project Structure

blog-writer-mcp/
├── bots/                      # 핵심 로직 / Core logic
│   ├── collector_bot.py       # 트렌드 수집 / Trend collection
│   ├── writer_bot.py          # AI 글쓰기 / AI writing
│   ├── publisher_bot.py       # Blogger 발행 / Blogger publishing
│   ├── wp_publisher_bot.py    # WordPress 발행 / WordPress publishing
│   ├── image_bot.py           # 이미지 생성 / Image generation
│   ├── analytics_bot.py       # 성과 분석 / Analytics
│   ├── linker_bot.py          # 쿠팡 링크 / Coupang links
│   └── engine_loader.py       # AI 엔진 팩토리 / AI engine factory
│
├── blogwriter_mcp/            # MCP 서버 / MCP server
│   ├── server.py              # FastMCP HTTP, :8766
│   └── tools/
│       ├── creative_dna.py    # 창작 DNA / Creative DNA
│       ├── seo_optimizer.py   # SEO + GEO
│       └── performance_feedback.py
│
├── config/
│   ├── engine.json            # AI 엔진 설정 / AI engine config
│   └── creative_dna.json      # DNA 설정 / DNA config
│
├── templates/                 # 프롬프트 템플릿 / Prompt templates
├── tests/                     # 테스트 (pytest 22 passed)
├── .env.example               # 환경변수 예시 / Env template
├── pyproject.toml
├── requirements.txt
└── README.md

---

FAQ

Q: 글쓰기 경험이 전혀 없어도 되나요?

됩니다. 오히려 이 도구가 더 필요한 분입니다. 당신이 감동받은 것들만 있으면 됩니다.

Yes. In fact, this tool is made for you. All you need is the things that moved you.

---

Q: 창작 DNA를 설정하지 않으면 어떻게 되나요?

일반적인 AI 글쓰기로 작동합니다. 언제든지 DNA를 설정하면 즉시 적용됩니다.

It works as a regular AI writer. Set your DNA anytime and it applies immediately.

---

Q: Blogger 외에 다른 플랫폼도 지원하나요?

현재 버전은 Google Blogger와 WordPress를 지원합니다. 네이버 블로그 지원은 이후 버전에서 확장할 수 있습니다.

Current version supports Google Blogger and WordPress. Naver Blog support can be added in a future version.

---

Q: Claude Desktop이 없으면 쓸 수 없나요?

Claude Desktop 또는 ChatGPT Plus/Pro 중 하나만 있으면 됩니다.

You need either Claude Desktop or ChatGPT Plus/Pro - just one of them.

---

Q: API 키가 많이 필요한가요?

기본 기능은 Google 계정만 있으면 됩니다. Telegram, 쿠팡, Search Console은 모두 선택 사항입니다.

Basic features only require a Google account. Telegram, Coupang, and Search Console are all optional.

---

Q: 상업적으로 사용해도 되나요?

MIT 라이선스입니다. 상업적 사용 포함 제한 없이 자유롭게 사용하실 수 있습니다.

MIT License. You can use it commercially and without restrictions.

---

기여 / Contributing

버그 리포트, 기능 제안, PR 모두 환영합니다.

Bug reports, feature suggestions, and PRs are all welcome.

# 로컬 개발 / Local development
git clone https://github.com/sinmb79/blog-writer_mcp.git
cd blog-writer_mcp
pip install -e ".[dev]"
pytest tests/ -v

---

Release Verification

python -m pytest tests -v
python -m compileall blogwriter bots dashboard blog_engine_cli.py blog_runtime.py runtime_guard.py
cd dashboard/frontend && npm run build

---

관련 프로젝트 / Related Projects

• sinmb79/blog-writer - 원본 블로그 자동화 / Original blog automation

---

만든 사람 / Author

22B Labs (sinmb79)

The 4th Path: ⟨H⊕A⟩ ↦ Ω

Human × AI → a better world.

22B Labs | the4thpath.com

---

The 4th Path: ⟨H⊕A⟩ ↦ Ω
Human × AI → a better world.