Сервер MCP Omnisend
Сервер Model Context Protocol (MCP), интегрируемый с Omnisend API V5, написанный на TypeScript.
Версия: 2.2.0
Функции
- Управление контактами (список, создание, получение, обновление)
- Управление продуктами (список, создание, получение, замена, удаление)
- Отслеживание событий
- Управление категориями продуктов
- Поддержка постраничной навигации на основе курсора со следующими/предыдущими URL-адресами и информацией об ограничениях/смещениях
Изменения в версии 2.2.0
- Реорганизованная кодовая база с приданием ей более модульной структуры
- Реализованы доменно-зависимые модули (контакты, продукты, категории, события)
- Организованный код в логические каталоги (/types, /filters, /api-resources, /resources, /tools)
- Сделал версию сервера динамической в инструменте ping
- Добавлена улучшенная обработка ошибок в запросах API.
- Улучшена поддержка кода с помощью экспорта стволов
- Удален избыточный и дублирующийся код
Изменения в версии 2.1.0
- Обновлено до @modelcontextprotocol/sdk v1.11.0
- Улучшенная обработка ошибок во всем приложении
- Повышенная стабильность API с улучшенными сообщениями об ошибках
- Добавлена настройка времени ожидания запроса для предотвращения зависания соединений.
- Исправлены проблемы с подключением SSE к MCP Inspector.
- Оптимизирован вывод консоли для совместимости с клиентами MCP
- Добавлен контекст пагинации на основе курсора в ответах MCP (следующие/предыдущие URL, ограничение/смещение)
Изменения в версии 2.0.0
- Перенесена вся кодовая база на TypeScript
- Обновленная структура ресурсов MCP в соответствии с последней спецификацией
- Добавлены правильные объявления типов для всех ответов и запросов API.
- Улучшенная обработка ошибок с типизированными исключениями
- Улучшенная организация кода и удобство его обслуживания
Установка
Здание
Для компиляции кода TypeScript:
Работа в режиме разработки
Для разработки с автоперезагрузкой:
Конфигурация
Создайте файл .env в корневом каталоге с вашим ключом API Omnisend:
OMNISEND_API_KEY=your_api_key_here
OMNISEND_API_URL=https://api.omnisend.com/v5
Использование
Чтобы запустить сервер MCP:
Взаимодействие с сервером MCP
Сервер MCP предназначен для использования с клиентами, которые понимают Model Context Protocol. Вот способы взаимодействия с ним:
Интеграция VS-кода
Для использования с VS Code предоставляется файл конфигурации в .vscode/mcp.json . VS Code с соответствующим расширением MCP может взаимодействовать с этим сервером.
Помощники ИИ
Помощники на основе искусственного интеллекта, такие как Claude, которые поддерживают MCP, могут взаимодействовать с этим сервером для доступа к данным Omnisend и выполнения операций.
Использование с Claude Desktop
Чтобы использовать этот MCP-сервер с Claude Desktop:
- Загрузите и установите Claude Desktop с официального сайта .
- Убедитесь, что в вашей системе установлен Node.js. Вы можете проверить это, запустив:Если Node.js не установлен, загрузите его с nodejs.org .
- Откройте меню Claude на вашем компьютере и выберите «Настройки...».
- Нажмите «Разработчик» в левой панели панели настроек, а затем нажмите «Изменить конфигурацию».
- Это откроет ваш файл конфигурации Claude Desktop. Замените содержимое файла или добавьте следующую конфигурацию:
{
"mcpServers": {
"omnisend": {
"command": "node",
"args": [
"/path/to/dist/index.js"
],
"env": {
"OMNISEND_API_KEY": "your_api_key_here"
}
}
}
}
your_api_key_here на ваш фактический ключ API Omnisend. - Сохраните файл конфигурации и перезапустите Claude Desktop.
- После перезапуска вы увидите значок молотка в правом нижнем углу поля ввода.
- Нажмите на значок молотка, чтобы увидеть доступные инструменты Omnisend.
- Теперь вы можете попросить Клода выполнить такие операции, как:
- «Список моих последних контактов в Omnisend»
- «Создать новый продукт в моем каталоге Omnisend»
- «Отправить событие клиента в Omnisend»
Пользовательские клиенты MCP
Вы можете разрабатывать собственные клиенты, используя библиотеку @modelcontextprotocol/sdk :
import { McpClient } from '@modelcontextprotocol/sdk/client/mcp';
import { ProcessClientTransport } from '@modelcontextprotocol/sdk/client/process';
const transport = new ProcessClientTransport(serverProcess);
const client = new McpClient(transport);
// Connect to the server
await client.connect();
// Execute tools
const result = await client.executeTool("listContacts", { limit: 10 });
API-документация
Более подробную информацию об API Omnisend можно найти в официальной документации .
Лицензия
Данный проект лицензирован в соответствии с лицензией Apache License 2.0 — подробности см. в файле LICENSE .