Skip to main content
Glama

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

list_blogs

Liste der Blogs des authentifizierten Benutzers

get_blog_by_url

Blog-URL → Blog-ID abrufen

list_posts

Liste der Blogbeiträge (unterstützt Status-Filter)

get_post

Einen bestimmten Beitrag abrufen

create_post

Neuen Beitrag erstellen (als Entwurf speichern mit isDraft=true)

update_post

Beitrag bearbeiten (Titel/Inhalt/Labels)

delete_post

Beitrag dauerhaft löschen

publish_post

Entwurf veröffentlichen

revert_post

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 v3
  • Authentifizierung: OAuth 2.0 (Desktop-App). Beim ersten Mal wird mit npm run auth ein lokaler Callback-Server gestartet, um das Token zu empfangen und unter ~/.config/blogger-mcp/token.json zu speichern. Die automatische Aktualisierung erfolgt danach über das Refresh-Token.

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

  • Transport: 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 build

2. 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.json

Detaillierte 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.js

Oder direkt in ~/.claude.json:

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

Umgebungsvariablen

Variable

Standardwert

Beschreibung

BLOGGER_MCP_CRED_DIR

~/.config/blogger-mcp

Verzeichnis für Anmeldedaten

BLOGGER_MCP_CLIENT_SECRET

$CRED_DIR/client_secret.json

Pfad zur OAuth-Client-JSON

Blogger API v3 Authentifizierung einrichten (Zusammenfassung)

  1. Google Cloud-Projekt erstellen — https://console.cloud.google.com/

  2. In der API-Bibliothek die Blogger API v3 aktivieren

  3. OAuth-Zustimmungsbildschirm konfigurieren

    • Benutzertyp: Extern

    • Scope hinzufügen: https://www.googleapis.com/auth/blogger

    • Eigenes Google-Konto als Testnutzer hinzufügen

  4. Anmeldedaten → OAuth-Client-ID

    • Anwendungstyp: Desktop-App

    • Nach Erstellung JSON herunterladen → ~/.config/blogger-mcp/client_secret.json

  5. Blog-ID prüfen

    • Die Zahl hinter blogID=... in der Blogger-Admin-URL oder über das Tool get_blog_by_url abrufen

Projektspezifische Detailanleitungen werden unter docs/vibe/mcp/blogger-mcp.md im 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. Run npm run auth first.

  • 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 tools
create_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

    A3.5/5.0

    Scored across 9 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness5/5

    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

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers