blogger-mcp
blogger-mcp
Ein benutzerdefinierter MCP-Server auf Basis der Google Blogger API v3. Er stellt Tools bereit, mit denen Sie Ihre Blogger-Beiträge in MCP-Hosts wie Claude Code oder Claude Desktop abrufen, erstellen, bearbeiten und löschen können.
Hauptfunktionen (MCP Tools)
Tool | Beschreibung |
| Liste der Blogs des authentifizierten Benutzers |
| Blog-URL → Blog-ID abrufen |
| Liste der Blogbeiträge (unterstützt Status-Filter) |
| Einen bestimmten Beitrag abrufen |
| Neuen Beitrag erstellen (als Entwurf speichern mit |
| Beitrag bearbeiten (Titel/Inhalt/Labels) |
| Beitrag dauerhaft löschen |
| Entwurf veröffentlichen |
| Veröffentlichten Beitrag zurück in Entwurf umwandeln |
Related MCP server: MCP-Google-Doc
Architektur
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 v3Authentifizierung: OAuth 2.0 (Desktop-App). Beim ersten Mal wird mit
npm run authein lokaler Callback-Server gestartet, um das Token zu empfangen und unter~/.config/blogger-mcp/token.jsonzu speichern. Die automatische Aktualisierung erfolgt danach über das Refresh-Token.Scopes:
https://www.googleapis.com/auth/bloggerTransport: stdio (MCP-Host startet als Kindprozess)
Schnellstart
1. Installation und Build
git clone https://github.com/mech12/blogger-mcp.git
cd blogger-mcp
npm install
npm run build2. OAuth-Client vorbereiten
Aktivieren Sie die Blogger API v3 in der Google Cloud Console, erstellen Sie einen OAuth-Client vom Typ Desktop-App und laden Sie die client_secret.json herunter.
mkdir -p ~/.config/blogger-mcp
cp /path/to/client_secret.json ~/.config/blogger-mcp/client_secret.jsonDetaillierte Informationen zur Google Cloud-Einrichtung finden Sie unter Blogger API v3 Authentifizierung einrichten weiter unten.
3. Erstmalige Authentifizierung
npm run authÖffnen Sie die im Browser angezeigte URL und stimmen Sie zu; daraufhin wird ~/.config/blogger-mcp/token.json erstellt.
4. In Claude Code registrieren
claude mcp add blogger --scope user -- node /absolute/path/to/blogger-mcp/dist/index.jsOder direkt in ~/.claude.json:
{
"mcpServers": {
"blogger": {
"command": "node",
"args": ["/absolute/path/to/blogger-mcp/dist/index.js"]
}
}
}Umgebungsvariablen
Variable | Standardwert | Beschreibung |
|
| Verzeichnis für Anmeldedaten |
|
| Pfad zur OAuth-Client-JSON |
Blogger API v3 Authentifizierung einrichten (Zusammenfassung)
Google Cloud-Projekt erstellen — https://console.cloud.google.com/
In der API-Bibliothek die
Blogger API v3aktivierenOAuth-Zustimmungsbildschirm konfigurieren
Benutzertyp: Extern
Scope hinzufügen:
https://www.googleapis.com/auth/bloggerEigenes Google-Konto als Testnutzer hinzufügen
Anmeldedaten → OAuth-Client-ID
Anwendungstyp: Desktop-App
Nach Erstellung JSON herunterladen →
~/.config/blogger-mcp/client_secret.json
Blog-ID prüfen
Die Zahl hinter
blogID=...in der Blogger-Admin-URL oder über das Toolget_blog_by_urlabrufen
Projektspezifische Detailanleitungen werden unter
docs/vibe/mcp/blogger-mcp.mdim Host-Projekt verwaltet.
Implementierungsplan (Design Notes)
Stack: TypeScript + Node 18+,
@modelcontextprotocol/sdk,googleapis,google-auth-library.Speicherort für Token:
~/.config/blogger-mcp/. Geschützt durch.gitignore.Fehlerstrategie: Tool-Aufruffehler werden von MCP automatisch in Fehler verpackt. Bei fehlender Authentifizierung erscheint der Hinweis:
No stored token. Runnpm run authfirst.Erweiterungs-Roadmap:
Markdown-zu-HTML-Konvertierungstool (basiert auf
marked)Bild-Upload (Blogger erfordert Umweg über Picasa/Google Photos → zukünftige Option)
Geplante Veröffentlichung (Setzen des
published-Feldes)
Entwicklung
npm run dev # tsc --watch
npm run build # dist/ 생성
npm start # dist/index.js 실행 (MCP stdio 서버)
npm run auth # OAuth 최초 인증Lizenz
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