Skip to main content
Glama

blogger-mcp

Un servidor MCP personalizado basado en la API v3 de Google Blogger. Proporciona herramientas para que los hosts de MCP, como Claude Code o Claude Desktop, puedan consultar, escribir, editar y eliminar entradas en tu blog de Blogger.

Funciones principales (Herramientas MCP)

Herramienta

Descripción

list_blogs

Lista de blogs del usuario autenticado

get_blog_by_url

URL del blog → Consulta de ID de blog

list_posts

Lista de entradas del blog (soporta filtro de estado)

get_post

Consulta de una entrada específica

create_post

Crear una nueva entrada (guardado temporal con isDraft=true)

update_post

Editar entrada (título/contenido/etiquetas)

delete_post

Eliminar entrada permanentemente

publish_post

Publicar una entrada guardada temporalmente

revert_post

Revertir una entrada publicada a borrador

Related MCP server: MCP-Google-Doc

Arquitectura

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
  • Autenticación: OAuth 2.0 (aplicación de escritorio). La primera vez, se ejecuta npm run auth para iniciar un servidor de callback local, obtener el token y guardarlo en ~/.config/blogger-mcp/token.json. Se renueva automáticamente después mediante el token de actualización.

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

  • Transporte: stdio (el host MCP lo inicia como un proceso hijo)

Inicio rápido

1. Instalación y compilación

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

2. Preparación del cliente OAuth

Activa la API v3 de Blogger en la Google Cloud Console, genera un cliente OAuth de tipo aplicación de escritorio y descarga el archivo client_secret.json.

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

Consulta la sección Emisión de autenticación de la API v3 de Blogger a continuación para obtener detalles sobre la configuración de Google Cloud.

3. Autenticación inicial

npm run auth

Abre la URL que aparece en el navegador y, tras aceptar, se creará el archivo ~/.config/blogger-mcp/token.json.

4. Registro en Claude Code

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

O directamente en ~/.claude.json:

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

Variables de entorno

Variable

Valor predeterminado

Descripción

BLOGGER_MCP_CRED_DIR

~/.config/blogger-mcp

Directorio de credenciales

BLOGGER_MCP_CLIENT_SECRET

$CRED_DIR/client_secret.json

Ruta del JSON del cliente OAuth

Emisión de autenticación de la API v3 de Blogger (resumen)

  1. Crear proyecto en Google Cloud — https://console.cloud.google.com/

  2. Biblioteca de API: Habilitar Blogger API v3

  3. Configurar pantalla de consentimiento OAuth

    • Tipo de usuario: Externo

    • Añadir ámbito (Scope): https://www.googleapis.com/auth/blogger

    • Añadir tu cuenta de Google como usuario de prueba

  4. Credenciales → ID de cliente OAuth

    • Tipo de aplicación: Aplicación de escritorio

    • Tras la creación, descarga el JSON → ~/.config/blogger-mcp/client_secret.json

  5. Verificar ID del blog

    • El número blogID=... en la URL del administrador de Blogger o mediante la herramienta get_blog_by_url

La guía detallada específica para el proyecto se gestiona en docs/vibe/mcp/blogger-mcp.md del proyecto host.

Plan de implementación (Notas de diseño)

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

  • Ubicación de almacenamiento de tokens: ~/.config/blogger-mcp/. Protegido con .gitignore.

  • Estrategia de errores: Los fallos en la llamada a herramientas son envueltos automáticamente por MCP. Si falta la autenticación, se guía al usuario con el mensaje No stored token. Run npm run auth first..

  • Hoja de ruta de expansión:

    • Herramienta de conversión de Markdown a HTML (basada en marked)

    • Carga de imágenes (Blogger requiere evitar Picasa/Google Photos → opción futura)

    • Publicación programada (configuración del campo published)

Desarrollo

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

Licencia

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
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers