cueapi-mcp

Официальный сервер Model Context Protocol для CueAPI, уровня координации с открытым исходным кодом для систем ИИ-агентов.

Предоставьте своему помощнику с поддержкой MCP (Claude Desktop, Cursor, Zed или любому другому MCP-хосту) возможность планировать работу агентов, получать историю выполнения и замыкать цикл с помощью отчетов о результатах, подкрепленных доказательствами, — и все это прямо из диалога.

Зачем

Агенты не завершают работу за один вызов. Они координируют действия во времени, инструментах, средах, между агентами и людьми. Каждая передача задачи — это место, где скрываются незаметные сбои. CueAPI завершает каждую передачу структурированным доказательством: внешним ID, URL-адресом результата или артефактом. Этот MCP-сервер дает агенту прямой доступ к этому интерфейсу, чтобы агент мог как планировать свою последующую работу, так и сообщать о результатах с подтверждением.

Related MCP server: moo-tasks

Установка

npm install -g @cueapi/mcp
# or use via npx (no install):
npx -y @cueapi/mcp

Настройка (Claude Desktop)

Добавьте это в конфигурацию Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json в macOS):

{
  "mcpServers": {
    "cueapi": {
      "command": "npx",
      "args": ["-y", "@cueapi/mcp"],
      "env": {
        "CUEAPI_API_KEY": "cue_sk_..."
      }
    }
  }
}

Сгенерируйте свой API-ключ на cueapi.ai. Используете self-hosting? Установите CUEAPI_BASE_URL вместе с CUEAPI_API_KEY.

Настройка (Cursor / Zed / другие хосты)

Любой MCP-хост, поддерживающий stdio-серверы, может запустить это. Укажите хосту путь к бинарному файлу cueapi-mcp и передайте CUEAPI_API_KEY в переменные окружения.

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

Пример диалога

Вы: Запланируй ежедневную задачу на 9 утра, которая отправляет дайджест на мой вебхук.

Помощник (использует cueapi_create_cue): Сигнал cue_abc123 создан, первое срабатывание завтра в 9:00 UTC.

Вы: Покажи мне последние пять раз, когда он запускался.

Помощник (использует cueapi_list_executions): ...

Разработка

npm install
npm test        # vitest smoke tests for the tool surface
npm run build   # compile TypeScript to dist/
npm run dev     # run the server locally with tsx

Ссылки

• Домашняя страница CueAPI: https://cueapi.ai

• Документация: https://docs.cueapi.ai

• Ядро (open source): https://github.com/cueapi/cueapi-core

• Model Context Protocol: https://modelcontextprotocol.io

Журнал изменений

• 0.4.1. Добавлен инструмент cueapi_update_cue: обновление изменяемых полей сигнала (имя, расписание, URL обратного вызова, часовой пояс, полезная нагрузка, описание). Обертка для PATCH /v1/cues/{id}. Частичное обновление — отправляются только предоставленные поля. Устраняет разрыв в паритете между обертками (все остальные клиентские обертки поддерживали обновление; MCP до сих пор — нет).

• 0.4.0. Добавлены пять инструментов жизненного цикла выполнения — cueapi_get_execution, cueapi_list_claimable_executions, cueapi_claim_execution, cueapi_claim_next_execution, cueapi_execution_heartbeat. Замыкает цикл получения-заявки-обработки-завершения для агентов MCP-хостов, которые хотят потреблять выполнения из транспортного уровня воркеров прямо во время сессии (например, Claude Desktop, Cursor, Zed). Основные моменты: list_claimable_executions фильтрует на стороне сервера через параметры запроса task / agent (клиентская фильтрация натыкается на известную ошибку ограничения LIMIT-50); claim_next_execution принимает опциональный task_name и внутренне распределяет запрос (отфильтрованный список → выбор самого старого → заявка по ID), так как сервер пока не поддерживает фильтр задач в базовой конечной точке заявки; execution_heartbeat отправляет worker_id через заголовок запроса X-Worker-Id (транспорт сервера для этого поля) и требует его в схеме, чтобы неправильно настроенные вызывающие стороны получали ошибку на уровне обертки, а не молча обходили защиту от состояний гонки. Внутреннее: CueAPIClient.request() получил опциональный параметр extraHeaders для поддержки пользовательских заголовков для каждого вызова.

• 0.3.0. Добавлен инструмент cueapi_fire_cue: немедленный запуск существующего сигнала с опциональным payload_override (и merge_strategy: 'merge' | 'replace', по умолчанию 'merge'). Обертка для POST /v1/cues/{id}/fire. Позволяет агентам запускать разовые выполнения без создания временных сигналов и позволяет динамическим данным каждого запуска проходить до отправки вебхука и ответов на заявки воркеров без изменения сохраненного сигнала.

• 0.1.4. Исправлены cueapi_pause_cue / cueapi_resume_cue для использования PATCH /v1/cues/{id} с {"status": "paused" | "active"} (ранее вызывались несуществующие конечные точки /pause и /resume, возвращая ошибку 404). PR #1. Это релиз, который действительно содержит исправление; версия 0.1.3 была опубликована преждевременно с этим примечанием, но без объединенного кода.

• 0.1.3. Преждевременная публикация, заменена версией 0.1.4. Функциональных изменений по сравнению с 0.1.2 нет.

• 0.1.2. Регистрация в официальном реестре MCP.

• 0.1.0. Первый релиз: 8 инструментов для создания / списка / получения / приостановки / возобновления / удаления сигналов, списка выполнений, отчета о результате.

Лицензия

MIT © Vector Apps Inc.