Contentful MCP Server
Сервер, реализующий протокол Model Context Protocol (MCP) для взаимодействия AI-ассистентов с API Contentful. Позволяет управлять контентом, медиафайлами, моделями данных и AI-действиями через естественный язык.
Возможности
- Создание и редактирование контента: создавайте, обновляйте и публикуйте записи (entries) и типы контента.
- Управление медиафайлами: загружайте, публикуйте и удаляйте ассеты.
- Работа с пространствами и окружениями: создавайте и настраивайте окружения, управляйте локалями и тегами.
- AI-действия: создавайте и запускайте AI-воркфлоу для автоматизации задач (например, перевод контента).
Установка
Требования
- Node.js и npm
- Аккаунт Contentful с Space ID
- Personal Access Token для Contentful Management API
Быстрая установка
Через Cursor: установить одним кликом.
Claude Desktop: скачайте .dxt-файл конфигурации из релизов и импортируйте его.
Установка из исходников
git clone https://github.com/contentful/contentful-mcp-server.git
cd contentful-mcp-server
npm install
npm run build
Настройка
Сервер настраивается через переменные окружения или JSON-конфиг вашего MCP-клиента (Cursor, VS Code, Claude Desktop).
Переменные окружения
| Переменная |
Обязательно |
По умолчанию |
Описание |
CONTENTFUL_MANAGEMENT_ACCESS_TOKEN |
Да |
— |
Токен Contentful Management API |
SPACE_ID |
Да |
— |
ID вашего пространства |
ENVIRONMENT_ID |
Нет |
master |
Целевое окружение |
CONTENTFUL_HOST |
Нет |
api.contentful.com |
Хост API |
NODE_ENV |
Нет |
production |
Режим Node.js |
Пример конфигурации
{
"mcpServers": {
"contentful-mcp": {
"command": "npx",
"args": ["-y", "@contentful/mcp-server"],
"env": {
"CONTENTFUL_MANAGEMENT_ACCESS_TOKEN": "your-CMA-token",
"SPACE_ID": "your-space-id",
"ENVIRONMENT_ID": "master",
"CONTENTFUL_HOST": "api.contentful.com"
}
}
}
}
Доступные инструменты
Сервер предоставляет более 30 инструментов, сгруппированных по категориям:
- Контекст и настройка:
get_initial_context — инициализация и инструкции.
- Типы контента: создание, чтение, обновление, публикация, удаление (
list_content_types, create_content_type, publish_content_type и др.).
- Записи: поиск, создание, редактирование, публикация/отмена публикации, удаление (
search_entries, create_entry, publish_entry и др.).
- Ассеты: загрузка, просмотр, обновление метаданных, публикация/удаление (
upload_asset, list_assets, publish_asset и др.).
- Пространства и окружения: управление пространствами и окружениями (
list_spaces, create_environment и др.).
- Локали: управление языками (
list_locales, create_locale и др.).
- Теги: создание и просмотр тегов (
list_tags, create_tag).
- AI-действия: создание, вызов, управление AI-воркфлоу (
create_ai_action, invoke_ai_action, list_ai_actions и др.).
Разработка
Тестирование с MCP Inspector
npx @modelcontextprotocol/inspector npx -y @contentful/mcp-server
Линтинг
npm run lint
Участие в разработке
Мы приветствуем вклад сообщества. Пожалуйста, ознакомьтесь с Contributing Guide.
Релизы
Версионирование и публикация автоматизированы через Nx Release на основе Conventional Commits.
Документация
Поддержка
Лицензия
MIT. См. LICENSE.
Проект включает компоненты с лицензиями MIT, BSD-2-Clause и Apache-2.0. Подробности — в NOTICE.
Кодекс поведения
Мы стремимся к безопасному и инклюзивному сообществу. Полный текст — Code of Conduct.
Комментарии
Комментариев пока нет. Будьте первым.