contentstack-mcp

Сервер Contentstack MCP

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

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

Функции

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

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

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

Клонируйте репозиторий:
git clone https://github.com/darekrossman/contentstack-mcp.git cd contentstack-mcp
Установите зависимости:
npm install
Настройте переменные среды:
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
Соберите и запустите сервер:
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:

Отредактируйте файл конфигурации Claude for Desktop:
- Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
Добавьте этот сервер в раздел 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" } } } }
Перезапустить Клода для рабочего стола

Курсор

Чтобы использовать этот сервер с 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.