Adaptateur d'API pour Blogger (MCP)

Ce module implémente un point d'accès basé sur le Protocole de Contexte Modèle (MCP) pour interagir avec l'infrastructure de gestion de blogs de Google Blogger.

Aperçu Technique

Ce serveur agit comme un pont permettant aux entités d'IA (telles que Claude) d'exécuter des opérations CRUD (Create, Read, Update, Delete) sur les entrées de blog et de gérer les systèmes d'étiquetage associés, en utilisant les fonctionnalités exposées par l'API RESTful de Blogger v3.

Opérations Supportées :

Récupération et énumération des journaux (blogs).
Manipulation complète des articles (récupération, création, modification, suppression).
Gestion des métadonnées d'organisation (étiquettes/labels).

Avertissement d'API : L'implémentation respecte les contraintes de l'API Google ; l'instanciation de nouveaux journaux n'est pas réalisable via cet accès programmatique et requiert une intervention manuelle sur le portail Blogger.

Mise en Œuvre et Configuration Pratique

Dépendances Requises

Assurez-vous d'avoir une installation fonctionnelle de Node.js (version 16+ recommandée) et une clé d'accès API valide pour Blogger.

Installation du Logiciel

Installation globale via gestionnaire de paquets :

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

Alternativement, pour une intégration locale :

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

En cas de problèmes de typage lors de la compilation :

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

Paramétrage de la Clé d'Accès (Secret)

L'accès nécessite une clé d'autorisation obtenue via la Google Cloud Console, après activation de l'API Blogger v3.

Configuration dans le fichier de configuration du client MCP (ex: config.json pour Claude Desktop) :

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

Lancement du Service

L'initialisation nécessite que la variable d'environnement BLOGGER_API_KEY soit renseignée.

Environnement de Développement :

bash export BLOGGER_API_KEY=votre_cle_api ./start-dev.sh

Environnement de Production :

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

Interaction Client

Une fois le service actif, les requêtes peuvent être formulées en langage naturel adressées au client MCP. Exemples d'intentions traduites :

"Rapporte la liste complète de mes propriétés Blogger."
"Publie un nouvel article intitulé 'Analyse du Spectre' sur le blog identifié par 123456, avec le corps de texte correspondant."
"Effectue une recherche thématique pour le terme 'apprentissage automatique' dans les publications actuelles."

Stratégies de Déploiement

Le projet est préconfiguré pour divers environnements d'hébergement :

Vercel

Utilisez le fichier vercel.json fourni. Assurez-vous de sécuriser la clé API en tant que secret Vercel (vercel secrets add blogger_api_key "...").

Conteneurisation (Docker)

L'image Docker simplifie l'isolation :

Construction de l'artefact : bash docker build -t blogger-mcp-server .

Exécution en fournissant la clé via variable d'environnement : bash docker run -p 3000:3000 -e BLOGGER_API_KEY=votre_cle_api blogger-mcp-server

Architecture Interne

La structure modulaire est organisée autour des préoccupations suivantes :

index.ts : Point d'entrée de l'application.
server.ts : Configuration du noyau de communication MCP.
bloggerService.ts : Logique métier dédiée aux appels directs à l'API Blogger.
config.ts : Gestion des paramètres d'exécution.
types.ts : Définitions des structures de données.
mcp-sdk-mock.ts : Implémentation de substitution pour isoler les dépendances directes au SDK MCP.

Restrictions Opérationnelles

Création de Blog : Strictement impossible via l'API. Pré-création requise.
Recherche de Contenu : L'API ne propose pas de recherche globale. Le filtrage est effectué a posteriori sur les ensembles de données récupérés.
Authentification : Se limite à l'utilisation d'une clé API statique, limitant l'accès aux contenus publics ou explicitement configurés pour cette clé.

Licence et Contributions

Ce code est mis à disposition sous les termes de la licence MIT. Les soumissions de correctifs ou d'améliorations sont encouragées via les pull requests.