return0 MCP Server

официальный

Отлаживайте ваши удаленные приложения Node.js и Next.js напрямую из вашей AI IDE, такой как Cursor.

GitHub
1

Документация

@return-0/mcp-server

MCP-сервер (Model Context Protocol) для return0 — инструмента отладки production-приложений в реальном времени.

О return0

return0 позволяет разработчикам отлаживать production-приложения на Node.js в реальном времени. Он даёт возможность отслеживать и устранять неполадки в приложениях, подключаясь к живым переменным, наблюдая за ходом выполнения и понимая поведение среды выполнения прямо в Cursor IDE. Это особенно полезно для отладки production-приложений, созданных с помощью Next.js и развёрнутых на платформах вроде Vercel, где традиционные методы отладки могут быть затруднительны.

Chat Demo

Настройка в Cursor

Чтобы использовать этот MCP-сервер с Cursor IDE, необходимо настроить его в параметрах Cursor. Сначала вам понадобится получить API-ключ return0.

Получение API-ключа

Чтобы получить API-ключ return0, посетите документацию return0. Документация проведёт вас через процесс получения API-ключа.

Получив API-ключ, вы можете настроить MCP-сервер одним из двух способов:

Вариант 1: Установка в один клик

Нажмите кнопку ниже, чтобы автоматически установить и настроить MCP-сервер return0 в Cursor:

Add to Cursor

Это автоматически настроит MCP-сервер. Примечание: После установки вам потребуется добавить ваш API-ключ return0 в конфигурацию. Инструкции по получению API-ключа смотрите в разделе Получение API-ключа выше, а подробности о том, как его добавить, — в разделе ручной настройки ниже.

Вариант 2: Ручная настройка

Если вы предпочитаете настраивать вручную, выполните следующие шаги в Cursor IDE:

  1. Откройте Cursor IDE
  2. Перейдите в Settings (или Preferences на macOS):
    • Нажмите значок шестерёнки (⚙️) в левом нижнем углу или
    • Используйте сочетание клавиш: Ctrl+, (Windows/Linux) или Cmd+, (macOS)
  3. В строке поиска настроек введите «MCP» или «Model Context Protocol»
  4. Нажмите MCP Servers или перейдите в раздел настройки MCP
  5. Нажмите Add Server или кнопку +, чтобы добавить новый MCP-сервер
  6. Введите следующую конфигурацию:
    • Name: return0
    • Command: npx
    • Args: -y, @return-0/mcp-server
    • Environment Variables: Добавьте RETURN0_API_KEY со значением вашего API-ключа
  7. Нажмите Save или Apply, чтобы сохранить конфигурацию

Конфигурация должна выглядеть примерно так в вашем файле mcp.json:

{
  "mcpServers": {
    "return0": {
      "command": "npx",
      "args": ["-y", "@return-0/mcp-server"],
      "env": {
        "RETURN0_API_KEY": "your-api-key-here"
      }
    }
  }
}

Примечание: Замените "your-api-key-here" на ваш реальный API-ключ return0. Если у вас ещё нет API-ключа, смотрите раздел Получение API-ключа выше для получения инструкций, либо вы можете использовать "demo" для тестирования. MCP-сервер будет автоматически установлен через npx при запуске Cursor.

Инструменты

Этот MCP-сервер предоставляет инструмент variable_extractor, который может использоваться MCP-совместимыми клиентами.

Инструмент: variable_extractor

Извлекает значение, тип и временную метку переменных среды выполнения из production-кода.

Входная схема:

{
  files: Array<{
    fileName: string;        // Full absolute path to the file
    variables: Array<{
      name: string;          // Variable name to extract
      lineNumber: number;    // Line number where variable is defined
    }>
  }>
}

Пример:

{
  "files": [
    {
      "fileName": "C:\\Users\\username\\project\\src\\app\\api\\route.ts",
      "variables": [
        {
          "name": "userData",
          "lineNumber": 42
        }
      ]
    }
  ]
}

Как это работает

  1. MCP-сервер получает запросы на извлечение значений переменных среды выполнения из production-кода
  2. Он считывает исходные файлы из локальной файловой системы
  3. Использует анализ AST TypeScript для корректировки номеров строк с целью точного определения местоположения переменных
  4. Подключается к работающему production-приложению для получения актуальных значений переменных
  5. Возвращает скорректированные данные извлечения переменных с реальными значениями, типами и временными метками среды выполнения

Лицензия

Подробности смотрите в файле LICENSE.

Автор

return0

Ссылки