blogger-mcp-server

=======

MCP Server for Blogger

A Model Context Protocol (MCP) server that allows artificial intelligence models like Claude to interact directly with Google's Blogger API.

About

This project implements a Model Context Protocol (MCP)-compliant server for Google's Blogger API. It allows AI models like Claude to interact with Blogger blogs to:

• List and retrieve blogs
• List, search, retrieve, create, update and delete posts
• List and retrieve labels

Important note : Google's Blogger API does not allow new blogs to be created via the API. This limitation is documented by Google. Blogs must be created manually via the Blogger web interface.

Prerequisites

• Node.js (version 16 or higher)
• A Google Blogger API key

Facility

Installing from npm

Installation from source code

if error install:

Configuration

Get a Blogger API key

1. Access the Google Cloud Console
2. Create a new project or select an existing project
3. Enable Blogger API v3
4. Create an API key
5. Note this key for use in configuration

MCP Server Configuration

Create a configuration file for your MCP client. Here's an example for Claude Desktop:

Replace VOTRE_CLE_API_ICI with the API key you obtained.

Use

Local boot

The project includes two scripts to facilitate starting the server:

Development mode

This script checks for the presence of the API key, installs dependencies if necessary, compiles the project if necessary, and then starts the server in development mode.

Production mode

This script checks for the presence of the API key and that the project is compiled, then starts the server in production mode.

Use with an MCP client

Once configured, you can use the MCP server for Blogger with any compatible MCP client, such as Claude Desktop.

Examples of commands:

• "List all my Blogger blogs"
• "Create a new post on my blog with the ID 123456 with the title 'My new post' and the content 'Here is the content of my post'"
• "Search for posts containing the word 'technology' in my blog"
• "Update the post with ID 789012 to change its title to 'New Title'"

Deployment options

Deployment on Vercel

The project includes a vercel.json file to facilitate deployment to Vercel:

1. Create an account on Vercel if you don't already have one
2. Install the Vercel CLI tool: npm install -g vercel
3. Log in to your Vercel account: vercel login
4. Configure your secret environment variable: vercel secrets add blogger_api_key "VOTRE_CLE_API_ICI"
5. Deploy the project: vercel

Deployment with Docker

The project includes a Dockerfile to facilitate deployment in a Docker container:

1. Build the Docker image:
   docker build -t blogger-mcp-server .
2. Run the container:
   docker run -p 3000:3000 -e BLOGGER_API_KEY=votre_cle_api blogger-mcp-server

Other deployment options

The server can also be deployed on other Node.js compatible platforms:

1. Heroku : Use a Procfile and Heroku Environment Variables
2. AWS Lambda : Use an adapter as a Serverless Framework
3. Google Cloud Run : Use the included Dockerfile

Project structure

The MCP server for Blogger is composed of several modules:

• index.ts : Main entry point
• server.ts : MCP Server Configuration
• bloggerService.ts : Service for interacting with the Blogger API
• config.ts : Server configuration
• types.ts : Definition of types and interfaces
• mcp-sdk-mock.ts : Simplified implementation of the MCP SDK to avoid dependency issues

Known limitations

• Creating Blogs : Google's Blogger API does not allow you to create new blogs via API. Blogs must be created manually through the Blogger web interface.
• Post Search : The Blogger API does not provide a direct endpoint for searching. This functionality is implemented client-side by fetching posts and then filtering them.
• Label Management : The Blogger API does not provide direct endpoints for label management. This functionality is implemented by extracting labels from posts.
• Authentication : This server uses API key authentication only, which limits access to public blogs or blogs for which you have explicitly configured access.

Contribution

Contributions are welcome! Feel free to open an issue or a pull request.

License

This project is licensed under the MIT License.

cf72ca4 (Adding new features)