blogger-mcp
blogger-mcp
Google Blogger API v3 기반의 커스텀 MCP 서버. Claude Code / Claude Desktop 등 MCP 호스트에서 자신의 Blogger 블로그에 글을 조회/작성/수정/삭제할 수 있도록 도구(tools)를 제공합니다.
주요 기능 (MCP Tools)
도구 | 설명 |
| 인증된 사용자의 블로그 목록 |
| 블로그 URL → Blog ID 조회 |
| 블로그 글 목록 (status 필터 지원) |
| 특정 글 조회 |
| 새 글 작성 ( |
| 글 수정 (title/content/labels) |
| 글 영구 삭제 |
| 임시 저장 글 발행 |
| 발행된 글을 임시 저장으로 되돌림 |
Related MCP server: MCP-Google-Doc
아키텍처
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/bloggerTransport: stdio (MCP host가 자식 프로세스로 기동)
빠른 시작
1. 설치 및 빌드
git clone https://github.com/mech12/blogger-mcp.git
cd blogger-mcp
npm install
npm run build2. 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"]
}
}
}환경변수
변수 | 기본값 | 설명 |
|
| 자격 증명 디렉터리 |
|
| OAuth 클라이언트 JSON 경로 |
Blogger API v3 인증 발급 (요약)
Google Cloud 프로젝트 생성 — https://console.cloud.google.com/
API 라이브러리에서
Blogger API v3사용 설정OAuth 동의 화면 구성
User Type: 외부(External)
Scope 추가:
https://www.googleapis.com/auth/blogger테스트 사용자에 본인 Google 계정 추가
사용자 인증 정보 → OAuth 클라이언트 ID
애플리케이션 유형: 데스크톱 앱
생성 후 JSON 다운로드 →
~/.config/blogger-mcp/client_secret.json
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
Available Tools
9 toolscreate_postC
Create a new blog post. Content is HTML; labels is a list of tags. isDraft=true saves as draft.
Inputs: blogId (required), title (required), content (required), labels, +1 more.
delete_postC
Delete a post permanently
Inputs: blogId (required), postId (required).
get_blog_by_urlC
Resolve a Blog ID from a blog URL (e.g. https://xxx.blogspot.com)
Inputs: url (required).
get_postC
Fetch a single post
Inputs: blogId (required), postId (required).
list_blogsB
List blogs owned by the authenticated user
Inputs: no named parameters.
list_postsC
List posts of a blog
Inputs: blogId (required), maxResults, status.
publish_postC
Publish a draft post
Inputs: blogId (required), postId (required).
revert_postC
Revert a published post back to draft
Inputs: blogId (required), postId (required).
update_postC
Update an existing post (title/content/labels).
Inputs: blogId (required), postId (required), title, content, +1 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 9 tools
Every tool has a clearly distinct purpose with no ambiguity. Each tool targets a specific resource (blog, post) and action (create, delete, get, list, publish, revert, update), making it easy for an agent to select the correct one. The separation between operations like publish_post and revert_post is particularly clear.
All tool names follow a consistent verb_noun pattern with snake_case throughout, such as create_post, delete_post, and list_blogs. There are no deviations in naming conventions, making the set predictable and readable for an agent.
With 9 tools, this server is well-scoped for managing blogs and posts, covering essential operations without bloat. Each tool earns its place by addressing a specific need in the blogging workflow, from listing blogs to handling post lifecycles.
The tool surface provides complete CRUD/lifecycle coverage for the blogging domain. It includes create, read (get/list), update, and delete for posts, plus additional lifecycle actions like publish and revert, with no obvious gaps that would cause agent failures.
Maintenance
Related MCP Connectors
An MCP server for the BlogCaster project.
Create, edit, organize, publish, and configure JustBlogged blogs from MCP clients.
Hosted MCP for BlogBat: read, write, generate, and publish blog articles and content.
Hosted MCP for BlogBat: read, write, generate, and publish blog articles and content.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceMCP server for managing Ghost blogs from AI coding editors. Create, edit, publish, and sync blog posts directly from tools like Claude Code or Cursor.38 npm1MIT
- AlicenseNot gradedqualityDmaintenanceMCP server that allows you to connect to Google Docs through Claude, enabling listing, reading, creating, updating, searching, and deleting documents.48MIT
- FlicenseDqualityDmaintenanceMCP server for blog management that provides tools to get, search, and create blog posts via a mock API.3-
- AlicenseNot gradedqualityDmaintenanceMCP server for managing Blogger posts: create, update, retrieve posts, and upload images to GCS via natural language.2MIT