blogger-mcp-сервер

=======

MCP-сервер для Blogger

Сервер протокола контекста модели (MCP), который позволяет моделям искусственного интеллекта, таким как Клод, напрямую взаимодействовать с API Blogger от Google.

О

В этом проекте реализован сервер, совместимый с Model Context Protocol (MCP) для API Blogger от Google. Он позволяет моделям ИИ, таким как Клод, взаимодействовать с блогами Blogger для:

• Список и извлечение блогов

• Список, поиск, извлечение, создание, обновление и удаление сообщений

• Список и извлечение меток

Важное примечание : API Blogger от Google не позволяет создавать новые блоги через API. Это ограничение задокументировано Google. Блоги необходимо создавать вручную через веб-интерфейс Blogger.

Related MCP server: Blogger MCP Server

Предпосылки

• Node.js (версия 16 или выше)

• API-ключ Google Blogger

Средство

Установка из npm

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

Установка из исходного кода

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

если произошла ошибка установки:

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

Конфигурация

Получить ключ API Blogger

1. Доступ к консоли Google Cloud

2. Создайте новый проект или выберите существующий проект

3. Включить API Blogger v3

4. Создать ключ API

5. Запомните этот ключ для использования в конфигурации.

Конфигурация сервера MCP

Создайте файл конфигурации для вашего клиента MCP. Вот пример для Claude Desktop:

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

Замените VOTRE_CLE_API_ICI на полученный вами ключ API.

Использовать

Локальная загрузка

Проект включает в себя два скрипта для облегчения запуска сервера:

Режим разработки

export BLOGGER_API_KEY=votre_cle_api
./start-dev.sh

Этот скрипт проверяет наличие ключа API, при необходимости устанавливает зависимости, при необходимости компилирует проект, а затем запускает сервер в режиме разработки.

Режим производства

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

Этот скрипт проверяет наличие ключа API и компиляцию проекта, а затем запускает сервер в производственном режиме.

Использование с клиентом MCP

После настройки вы сможете использовать сервер MCP для Blogger с любым совместимым клиентом MCP, например Claude Desktop.

Примеры команд:

• «Список всех моих блогов Blogger»

• «Создайте новый пост в моем блоге с идентификатором 123456, заголовком «Мой новый пост» и содержимым «Вот содержание моего поста»»

• «Поиск сообщений, содержащих слово «технология» в моем блоге»

• «Обновите публикацию с идентификатором 789012, чтобы изменить ее заголовок на «Новый заголовок»»

Варианты развертывания

Развертывание на Верселе

Проект включает файл vercel.json для упрощения развертывания в Vercel:

1. Создайте учетную запись на Vercel , если у вас ее еще нет.

2. Установите инструмент Vercel CLI: npm install -g vercel

3. Войдите в свою учетную запись Vercel: vercel login

4. Настройте секретную переменную среды: vercel secrets add blogger_api_key "VOTRE_CLE_API_ICI"

5. Развернуть проект: vercel

Развертывание с помощью Docker

Проект включает Dockerfile для упрощения развертывания в контейнере Docker:

1. Создайте образ Docker:

   docker build -t blogger-mcp-server .

2. Запустите контейнер:

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

Другие варианты развертывания

Сервер также можно развернуть на других платформах, совместимых с Node.js:

1. Heroku : использование Procfile и переменных среды Heroku

2. AWS Lambda : использование адаптера в качестве бессерверной платформы

3. Google Cloud Run : используйте прилагаемый Dockerfile

Структура проекта

Сервер MCP для Blogger состоит из нескольких модулей:

• index.ts : Основная точка входа

• server.ts : Конфигурация сервера MCP

• bloggerService.ts : Служба для взаимодействия с API Blogger

• config.ts : Конфигурация сервера

• types.ts : Определение типов и интерфейсов

• mcp-sdk-mock.ts : упрощенная реализация MCP SDK для избежания проблем с зависимостями

Известные ограничения

• Создание блогов : API Blogger от Google не позволяет создавать новые блоги через API. Блоги необходимо создавать вручную через веб-интерфейс Blogger.

• Поиск сообщений : API Blogger не предоставляет прямой конечной точки для поиска. Эта функциональность реализуется на стороне клиента путем извлечения сообщений и их последующей фильтрации.

• Управление метками : API Blogger не предоставляет прямых конечных точек для управления метками. Эта функциональность реализована путем извлечения меток из сообщений.

• Аутентификация : этот сервер использует только аутентификацию по ключу API, что ограничивает доступ к публичным блогам или блогам, для которых вы явно настроили доступ.

Вклад

Ваши вклады приветствуются! Не стесняйтесь открывать тему или запрос на включение внесенных изменений.

Лицензия

Данный проект лицензирован по лицензии MIT.

cf72ca4 (Добавление новых функций)