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)

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

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