Сервер Contentstack MCP

Этот сервер Model Context Protocol (MCP) интегрируется с API управления контентом Contentstack, позволяя помощникам на базе искусственного интеллекта, таким как Клод, взаимодействовать с вашей CMS Contentstack через стандартизированный протокол.

Примечание: Это ранняя версия Contentstack MCP Server. Ознакомьтесь с Roadmap для предстоящих улучшений и запланированных функций.

Оглавление

• Функции

• Установка

• Разработка

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

• Интеграция с помощниками на основе искусственного интеллекта

• Примеры использования

• Дорожная карта

• Лицензия

Related MCP server: mcp-clickup

Функции

Доступные ресурсы

• content-types : список всех типов контента (URI: contentstack://content-types )

• content-type : Получить тип контента по UID (URI: contentstack://content-type/{uid} )

• entries : Получить записи по типу контента (URI: contentstack://entries/{content_type_uid} )

• entry : Получить конкретную запись (URI: contentstack://entry/{content_type_uid}/{entry_uid} )

• assets : Список всех активов (URI: contentstack://assets )

Управление типом контента

• Создание, обновление и удаление типов контента

• Определите схемы, параметры, правила полей и таксономии

• Управление глобальными полями

Управление входом

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

• Публикация и отмена публикации записей в разных средах

• Запрос записей с возможностью фильтрации, разбиения на страницы и сортировки

Глобальное управление полями

• Создавайте и обновляйте глобальные поля для повторного использования в разных типах контента.

• Извлечение глобальных полей с параметрами пагинации

Контент-процессы

• Руководствуйтесь рабочими процессами создания контента

• Анализ контента и идеи

• Помощь в планировании миграции

Установка

Предпосылки

• Node.js (v16.0.0 или выше)

• Учетная запись Contentstack

• Учетные данные API (ключ API и токен управления)

Установка НПМ

Самый простой способ использовать этот MCP-сервер — через NPM:

# Install globally
npm install -g @drossman/contentstack-mcp

# Or use directly via npx
npx @drossman/contentstack-mcp

Ручная установка

1. Клонируйте репозиторий:

   git clone https://github.com/darekrossman/contentstack-mcp.git
   cd contentstack-mcp

2. Установите зависимости:

   npm install

3. Настройте переменные среды:

   cp .env.example .env

   Отредактируйте файл .env , используя ваши учетные данные Contentstack:

   CONTENTSTACK_API_KEY=your_api_key_here
   CONTENTSTACK_MANAGEMENT_TOKEN=your_management_token_here
   # Optional: Specify branch if using branches
   CONTENTSTACK_BRANCH=your_branch_name

4. Соберите и запустите сервер:

   npm run build
   npm start

Установка через Smithery CLI

Вы также можете установить этот сервер MCP с помощью Smithery CLI :

npx @smithery/cli install contentstack-mcp --client claude

Более подробную информацию и расширенные возможности использования см. в документации Smithery CLI .

Разработка

Настройка для разработки

Для разработки можно использовать:

npm run dev

Это запустит сервер с использованием ts-node для ускорения цикла разработки.

Качество кода

Этот проект использует Biome.js для линтинга и форматирования. Он обеспечивает единообразный стиль кода и помогает выявлять потенциальные проблемы на ранних стадиях.

Доступные команды

• Код линта :

  npm run lint

• Линт и исправление :

  npm run lint:fix

• Формат кода :

  npm run format

• Форматировать и исправить :

  npm run format:fix

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

Аутентификация

Этот сервер требует аутентификации с помощью API Contentstack:

Токен управления (обязательно) :

• Токен уровня стека с предопределенными разрешениями

• Устанавливается через переменную среды CONTENTSTACK_MANAGEMENT_TOKEN

• Сгенерировать из панели управления Contentstack: Настройки > Токены > Токены управления

Ключ API (обязательно) :

• Ключ API стека для аутентификации

• Устанавливается через переменную среды CONTENTSTACK_API_KEY

Поддержка филиала

Если ваша учетная запись Contentstack использует ветви, вы можете указать ветвь:

CONTENTSTACK_BRANCH=develop

Интеграция с помощниками на основе искусственного интеллекта

Клод для рабочего стола

Чтобы использовать этот сервер с Claude for Desktop:

1. Отредактируйте файл конфигурации Claude for Desktop:

   • Mac: ~/Library/Application Support/Claude/claude_desktop_config.json

   • Windows: %APPDATA%\Claude\claude_desktop_config.json

2. Добавьте этот сервер в раздел mcpServers :

   {
     "mcpServers": {
       "contentstack": {
         "command": "npx",
         "args": ["-y", "@drossman/contentstack-mcp"],
         "env": {
           "CONTENTSTACK_API_KEY": "your_api_key_here",
           "CONTENTSTACK_MANAGEMENT_TOKEN": "your_management_token_here"
         }
       }
     }
   }

3. Перезапустить Клода для рабочего стола

Курсор

Чтобы использовать этот сервер с Cursor, добавьте конфигурацию сервера Contentstack MCP:

{
   "mcpServers": {
      "contentstack": {
      "command": "npx",
      "args": ["-y", "@drossman/contentstack-mcp"],
      "env": {
         "CONTENTSTACK_API_KEY": "your_api_key_here",
         "CONTENTSTACK_MANAGEMENT_TOKEN": "your_management_token_here",
      }
      }
   }
}

Установить с помощью Smithery

Вы также можете установить этот сервер MCP с помощью Smithery CLI, используя клиент по вашему выбору:

npx -y @smithery/cli install @drossman/contentstack-mcp --client claude

Доступные клиенты включают:

• Клод

• клин

• виндсерфинг

• роокод

• остроумный

• enconvo

• курсор

• vscode

• vscode-инсайдеры

• болтай

• амазонка-bedrock

• амазонка

Более подробную информацию и расширенные возможности использования см. в документации Smithery CLI .

Дорожная карта

• [ ] Улучшенное понимание контекста ИИ : улучшение предоставления контекста для сложных запросов

• [ ] Расширенные запросы и фильтрация : поддержка фильтрации по нескольким критериям и настраиваемым полям

• [ ] Автоматизация рабочего процесса и публикации : включение действий рабочего процесса контента на основе ИИ

• [ ] Улучшения управления активами : добавление возможностей прямого управления активами

• [ ] Поддержка массовых операций : реализация пакетных операций для записей и активов

• [ ] Улучшенная обработка ошибок и обратная связь ИИ : уточнение сообщений об ошибках для использования ИИ

• [ ] Контекст и разрешения, зависящие от пользователя : настройка действий на основе разрешений пользователя

• [ ] Расширяемость для пользовательских инструментов : создание фреймворка расширения

• [ ] Обработка событий в реальном времени : добавление поддержки веб-перехватчиков для реактивного поведения ИИ

• [ ] Комплексная документация : разработка подробных руководств по взаимодействию с ИИ

Выкрикивать

Особая благодарность Иво Тоби . Этот проект и его автор во многом вдохновлены его работой в этой области.

Лицензия

Массачусетский технологический институт

Отказ от ответственности: Этот проект не связан, не одобрен и не поддерживается Contentstack. Это независимый проект с открытым исходным кодом, разработанный для работы с API Contentstack.