blogger-mcp
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 |
| Lista de blogs del usuario autenticado |
| URL del blog → Consulta de ID de blog |
| Lista de entradas del blog (soporta filtro de estado) |
| Consulta de una entrada específica |
| Crear una nueva entrada (guardado temporal con |
| Editar entrada (título/contenido/etiquetas) |
| Eliminar entrada permanentemente |
| Publicar una entrada guardada temporalmente |
| 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 v3Autenticación: OAuth 2.0 (aplicación de escritorio). La primera vez, se ejecuta
npm run authpara 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/bloggerTransporte: 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 build2. 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.jsonConsulta 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 authAbre 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.jsO 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 |
|
| Directorio de credenciales |
|
| Ruta del JSON del cliente OAuth |
Emisión de autenticación de la API v3 de Blogger (resumen)
Crear proyecto en Google Cloud — https://console.cloud.google.com/
Biblioteca de API: Habilitar
Blogger API v3Configurar pantalla de consentimiento OAuth
Tipo de usuario: Externo
Añadir ámbito (Scope):
https://www.googleapis.com/auth/bloggerAñadir tu cuenta de Google como usuario de prueba
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
Verificar ID del blog
El número
blogID=...en la URL del administrador de Blogger o mediante la herramientaget_blog_by_url
La guía detallada específica para el proyecto se gestiona en
docs/vibe/mcp/blogger-mcp.mddel 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. Runnpm run authfirst..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 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