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)

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

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