Blogger

Interaja com a API do Google Blogger para gerenciar blogs, postagens e comentários.

Documentação

blogger-mcp-server

=======

Servidor MCP para Blogger

Um servidor MCP (Model Context Protocol) que permite que modelos de inteligência artificial como o Claude interajam diretamente com a API Blogger do Google.

Sobre

Este projeto implementa um servidor compatível com o protocolo MCP (Model Context Protocol) para a API Blogger do Google. Ele permite que modelos de IA como o Claude interajam com blogs do Blogger para:

Listar e recuperar blogs
Listar, pesquisar, recuperar, criar, atualizar e excluir posts
Listar e recuperar labels

Nota importante: A API Blogger do Google não permite criar novos blogs via API. Essa limitação é documentada pelo Google. Os blogs devem ser criados manualmente por meio da interface web do Blogger.

Pré-requisitos

Node.js (versão 16 ou superior)
Uma chave de API Blogger do Google

Instalação

Instalação via npm

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

Instalação a partir do código-fonte

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

se ocorrer erro na instalação:

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

Configuração

Como obter uma chave de API Blogger

Acesse o Console Google Cloud
Crie um novo projeto ou selecione um projeto existente
Ative a API Blogger v3
Crie uma chave de API
Anote essa chave para usar na configuração

Configuração do servidor MCP

Crie um arquivo de configuração para o seu cliente MCP. Aqui está um exemplo para o Claude Desktop:

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

Substitua VOTRE_CLE_API_ICI pela chave de API que você obteve.

Uso

Inicialização local

O projeto inclui dois scripts para facilitar a inicialização do servidor:

Modo de desenvolvimento

export BLOGGER_API_KEY=votre_cle_api
./start-dev.sh

Este script verifica a presença da chave de API, instala as dependências se necessário, compila o projeto se necessário e, em seguida, inicia o servidor em modo de desenvolvimento.

Modo de produção

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

Este script verifica a presença da chave de API e se o projeto está compilado e, em seguida, inicia o servidor em modo de produção.

Uso com um cliente MCP

Uma vez configurado, você pode usar o servidor MCP para Blogger com qualquer cliente MCP compatível, como o Claude Desktop.

Exemplos de comandos:

"Liste todos os meus blogs do Blogger"
"Crie um novo post no meu blog com o ID 123456 com o título 'Meu novo post' e o conteúdo 'Aqui está o conteúdo do meu post'"
"Pesquise posts contendo a palavra 'tecnologia' no meu blog"
"Atualize o post com o ID 789012 para alterar o título para 'Novo título'"

Opções de implantação

Implantação na Vercel

O projeto inclui um arquivo vercel.json para facilitar a implantação na Vercel:

Crie uma conta na Vercel se você ainda não tiver uma
Instale a ferramenta CLI da Vercel: npm install -g vercel
Conecte-se à sua conta da Vercel: vercel login
Configure sua variável de ambiente secreta: vercel secrets add blogger_api_key "VOTRE_CLE_API_ICI"
Implante o projeto: vercel

Implantação com Docker

O projeto inclui um Dockerfile para facilitar a implantação em um contêiner Docker:

Construa a imagem Docker:
```
docker build -t blogger-mcp-server .
```

Execute o contêiner:

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

Outras opções de implantação

O servidor também pode ser implantado em outras plataformas compatíveis com Node.js:

Heroku: Use um Procfile e as variáveis de ambiente do Heroku
AWS Lambda: Use um adaptador como o Serverless Framework
Google Cloud Run: Use o Dockerfile incluído

Estrutura do projeto

O servidor MCP para Blogger é composto por vários módulos:

index.ts: Ponto de entrada principal
server.ts: Configuração do servidor MCP
bloggerService.ts: Serviço de interação com a API Blogger
config.ts: Configuração do servidor
types.ts: Definição de tipos e interfaces
mcp-sdk-mock.ts: Implementação simplificada do SDK MCP para evitar problemas de dependências

Limitações conhecidas

Criação de blogs: A API Blogger do Google não permite criar novos blogs via API. Os blogs devem ser criados manualmente por meio da interface web do Blogger.
Pesquisa de posts: A API Blogger não fornece um endpoint direto para pesquisa. Esse recurso é implementado no lado do cliente, recuperando os posts e depois filtrando-os.
Gerenciamento de labels: A API Blogger não fornece endpoints diretos para o gerenciamento de labels. Esse recurso é implementado extraindo os labels dos posts.
Autenticação: Este servidor usa apenas autenticação por chave de API, o que limita o acesso a blogs públicos ou a blogs para os quais você configurou explicitamente o acesso.

Contribuição

Contribuições são bem-vindas! Sinta-se à vontade para abrir uma issue ou um pull request.

Licença

Este projeto está licenciado sob a licença MIT.

cf72ca4 (Adição dos novos recursos)