blogger-mcp

Google Blogger API v3 기반의 커스텀 MCP 서버. Claude Code / Claude Desktop 등 MCP 호스트에서 자신의 Blogger 블로그에 글을 조회/작성/수정/삭제할 수 있도록 도구(tools)를 제공합니다.

주요 기능 (MCP Tools)

아키텍처

Claude Code ──stdio──► blogger-mcp (Node)
                          │
                          ├─ src/index.ts     : MCP server (tools 등록/디스패치)
                          ├─ src/auth.ts      : OAuth 2.0 토큰 로드/저장/갱신
                          └─ src/auth-cli.ts  : 최초 1회 대화형 인증용 CLI
                          │
                          ▼
                  Google Blogger API v3

• 인증: OAuth 2.0 (Desktop 앱). 최초 1회 npm run auth로 로컬 콜백 서버를 띄워 토큰을 받아 ~/.config/blogger-mcp/token.json에 저장. refresh token 으로 이후 자동 갱신됨.

• Scopes: https://www.googleapis.com/auth/blogger

• Transport: stdio (MCP host가 자식 프로세스로 기동)

빠른 시작

1. 설치 및 빌드

git clone https://github.com/mech12/blogger-mcp.git
cd blogger-mcp
npm install
npm run build

2. OAuth 클라이언트 준비

Google Cloud Console에서 Blogger API v3을 활성화하고 Desktop 앱 타입의 OAuth 클라이언트를 발급받아 client_secret.json을 다운로드.

mkdir -p ~/.config/blogger-mcp
cp /path/to/client_secret.json ~/.config/blogger-mcp/client_secret.json

자세한 Google Cloud 설정은 아래 Blogger API v3 인증 발급 참고.

3. 최초 인증

npm run auth

브라우저로 표시되는 URL을 열고 동의하면 ~/.config/blogger-mcp/token.json이 생성됩니다.

4. Claude Code에 등록

claude mcp add blogger --scope user -- node /absolute/path/to/blogger-mcp/dist/index.js

또는 ~/.claude.json에 직접:

{
  "mcpServers": {
    "blogger": {
      "command": "node",
      "args": ["/absolute/path/to/blogger-mcp/dist/index.js"]
    }
  }
}

환경변수

Blogger API v3 인증 발급 (요약)

1. Google Cloud 프로젝트 생성 — https://console.cloud.google.com/

2. API 라이브러리에서 Blogger API v3 사용 설정

3. OAuth 동의 화면 구성

   • User Type: 외부(External)

   • Scope 추가: https://www.googleapis.com/auth/blogger

   • 테스트 사용자에 본인 Google 계정 추가

4. 사용자 인증 정보 → OAuth 클라이언트 ID

   • 애플리케이션 유형: 데스크톱 앱

   • 생성 후 JSON 다운로드 → ~/.config/blogger-mcp/client_secret.json

5. Blog ID 확인

   • Blogger 관리자 URL의 blogID=... 숫자 또는 get_blog_by_url 도구로 조회

프로젝트에 특화된 상세 가이드는 호스트 프로젝트의 docs/vibe/mcp/blogger-mcp.md에서 관리합니다.

구현 계획 (Design Notes)

• 스택: TypeScript + Node 18+, @modelcontextprotocol/sdk, googleapis, google-auth-library.

• 토큰 저장 위치: ~/.config/blogger-mcp/. .gitignore로 보호.

• 에러 전략: tool 호출 실패는 MCP가 자동으로 에러 래핑. 인증 누락 시 No stored token. Run \npm run auth` first.` 메시지로 가이드.

• 확장 로드맵:

  • Markdown → HTML 변환 도구 (marked 기반)

  • 이미지 업로드(Blogger는 Picasa/Google Photos 우회 필요 → 차후 옵션)

  • 글 스케줄 발행 (published 필드 세팅)

개발

npm run dev       # tsc --watch
npm run build     # dist/ 생성
npm start         # dist/index.js 실행 (MCP stdio 서버)
npm run auth      # OAuth 최초 인증

라이선스

MIT