Blogger

Interactúa con la API de Google Blogger para gestionar blogs, entradas y comentarios.

GitHub
1
Prueba este MCPPatrocinado

Documentación

blogger-mcp-server

=======

Servidor MCP para Blogger

Un servidor MCP (Model Context Protocol) que permite a los modelos de inteligencia artificial como Claude interactuar directamente con la API de Blogger de Google.

Acerca de

Este proyecto implementa un servidor compatible con el protocolo MCP (Model Context Protocol) para la API de Blogger de Google. Permite a los modelos de IA como Claude interactuar con blogs de Blogger para:

  • Listar y recuperar blogs
  • Listar, buscar, recuperar, crear, actualizar y eliminar publicaciones
  • Listar y recuperar etiquetas

Nota importante: La API de Blogger de Google no permite crear nuevos blogs a través de la API. Esta limitación está documentada por Google. Los blogs deben crearse manualmente a través de la interfaz web de Blogger.

Requisitos previos

  • Node.js (versión 16 o superior)
  • Una clave de API de Blogger de Google

Instalación

Instalación desde npm

npm install -g @mcproadev/blogger-mcp-server

Instalación desde el código fuente

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

si error de instalación:

npm install --save-dev @types/express @types/socket.io

Configuración

Obtener una clave de API de Blogger

  1. Acceda a la Consola de Google Cloud
  2. Cree un nuevo proyecto o seleccione un proyecto existente
  3. Active la API de Blogger v3
  4. Cree una clave de API
  5. Anote esta clave para usarla en la configuración

Configuración del servidor MCP

Cree un archivo de configuración para su cliente MCP. Aquí hay un ejemplo para Claude Desktop:

{
  "mcpServers": {
    "blogger": {
      "command": "npx",
      "args": [
        "-y",
        "@mcproadev/blogger-mcp-server"
      ],
      "env": {
        "BLOGGER_API_KEY": "VOTRE_CLE_API_ICI"
      }
    }
  }
}

Reemplace VOTRE_CLE_API_ICI con la clave de API que obtuvo.

Uso

Inicio local

El proyecto incluye dos scripts para facilitar el inicio del servidor:

Modo de desarrollo

export BLOGGER_API_KEY=votre_cle_api
./start-dev.sh

Este script verifica la presencia de la clave de API, instala las dependencias si es necesario, compila el proyecto si es necesario y luego inicia el servidor en modo de desarrollo.

Modo de producción

export BLOGGER_API_KEY=votre_cle_api
npm run build
./start-prod.sh

Este script verifica la presencia de la clave de API y que el proyecto esté compilado, y luego inicia el servidor en modo de producción.

Uso con un cliente MCP

Una vez configurado, puede usar el servidor MCP para Blogger con cualquier cliente MCP compatible, como Claude Desktop.

Ejemplos de comandos:

  • "Lista todos mis blogs de Blogger"
  • "Crea una nueva publicación en mi blog con el ID 123456 con el título 'Mi nueva publicación' y el contenido 'Aquí está el contenido de mi publicación'"
  • "Busca publicaciones que contengan la palabra 'tecnología' en mi blog"
  • "Actualiza la publicación con el ID 789012 para cambiar su título a 'Nuevo título'"

Opciones de implementación

Implementación en Vercel

El proyecto incluye un archivo vercel.json para facilitar la implementación en Vercel:

  1. Cree una cuenta en Vercel si aún no tiene una
  2. Instale la herramienta CLI de Vercel: npm install -g vercel
  3. Conéctese a su cuenta de Vercel: vercel login
  4. Configure su variable de entorno secreta: vercel secrets add blogger_api_key "VOTRE_CLE_API_ICI"
  5. Implemente el proyecto: vercel

Implementación con Docker

El proyecto incluye un Dockerfile para facilitar la implementación en un contenedor Docker:

  1. Construya la imagen de Docker:

    docker build -t blogger-mcp-server .

  2. Ejecute el contenedor:

    docker run -p 3000:3000 -e BLOGGER_API_KEY=votre_cle_api blogger-mcp-server

Otras opciones de implementación

El servidor también se puede implementar en otras plataformas compatibles con Node.js:

  1. Heroku: Use un Procfile y las variables de entorno de Heroku
  2. AWS Lambda: Use un adaptador como Serverless Framework
  3. Google Cloud Run: Use el Dockerfile incluido

Estructura del proyecto

El servidor MCP para Blogger está compuesto por varios módulos:

  • index.ts: Punto de entrada principal
  • server.ts: Configuración del servidor MCP
  • bloggerService.ts: Servicio de interacción con la API de Blogger
  • config.ts: Configuración del servidor
  • types.ts: Definición de tipos e interfaces
  • mcp-sdk-mock.ts: Implementación simplificada del SDK MCP para evitar problemas de dependencias

Limitaciones conocidas

  • Creación de blogs: La API de Blogger de Google no permite crear nuevos blogs a través de la API. Los blogs deben crearse manualmente a través de la interfaz web de Blogger.
  • Búsqueda de publicaciones: La API de Blogger no proporciona un endpoint directo para la búsqueda. Esta funcionalidad se implementa en el lado del cliente recuperando las publicaciones y luego filtrándolas.
  • Gestión de etiquetas: La API de Blogger no proporciona endpoints directos para la gestión de etiquetas. Esta funcionalidad se implementa extrayendo las etiquetas de las publicaciones.
  • Autenticación: Este servidor utiliza únicamente la autenticación por clave de API, lo que limita el acceso a blogs públicos o a blogs para los que haya configurado explícitamente el acceso.

Contribución

¡Las contribuciones son bienvenidas! No dude en abrir un issue o una pull request.

Licencia

Este proyecto está bajo la licencia MIT.

cf72ca4 (Adición de nuevas funcionalidades)