Tideways MCP

MCP сервер, который позволяет AI-ассистентам запрашивать данные мониторинга производительности Tideways и предоставлять разговорные инсайты по производительности PHP-приложений.

Установка

NPX

npx tideways-mcp-server

Глобальная установка через NPM

npm install -g tideways-mcp-server

Конфигурация

Claude Desktop (NPX)

{
  "mcpServers": {
    "tideways": {
      "command": "npx",
      "args": ["tideways-mcp-server"],
      "env": {
        "TIDEWAYS_TOKEN": "your_token",
        "TIDEWAYS_ORG": "your_org",
        "TIDEWAYS_PROJECT": "your_project"
      }
    }
  }
}

Claude Desktop (глобальная)

{
  "mcpServers": {
    "tideways": {
      "command": "tideways-mcp-server",
      "env": {
        "TIDEWAYS_TOKEN": "your_token",
        "TIDEWAYS_ORG": "your_org",
        "TIDEWAYS_PROJECT": "your_project"
      }
    }
  }
}

VS Code с MCP расширением

{
  "mcp.servers": {
    "tideways": {
      "command": "npx",
      "args": ["tideways-mcp-server"],
      "env": {
        "TIDEWAYS_TOKEN": "your_token",
        "TIDEWAYS_ORG": "your_org",
        "TIDEWAYS_PROJECT": "your_project"
      }
    }
  }
}

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

Инструмент	Описание
`get_performance_metrics`	Получение агрегированных метрик производительности и системной статистики
`get_performance_summary`	Получение сводных данных производительности в виде временных рядов с 15-минутными интервалами для анализа трендов
`get_issues`	Получение и анализ недавних ошибок, исключений и проблем производительности
`get_traces`	Анализ отдельных образцов трассировки для детального выявления узких мест и отладки производительности
`get_historical_data`	Получение исторических данных производительности для конкретных дат с настраиваемой детализацией

Возможности

Разговорные инсайты производительности: получение данных производительности в формате естественного языка, оптимизированном для AI-ассистентов
Интеграция с AI-ассистентами: работает с Claude Desktop, Cursor, Claude Code и другими MCP-совместимыми инструментами
Метрики производительности в реальном времени: запрос текущих данных производительности с интеллектуальным ограничением скорости
Анализ проблем: получение и анализ ошибок, исключений и проблем производительности
Интеллектуальное управление API: встроенное ограничение скорости с учетом ограничений Tideways API
Надежная обработка ошибок: комплексная обработка ошибок с понятными пользователю сообщениями

Переменные окружения

Обязательные

TIDEWAYS_TOKEN - токен доступа к Tideways API
TIDEWAYS_ORG - название организации в Tideways
TIDEWAYS_PROJECT - название проекта в Tideways

Опциональные

TIDEWAYS_BASE_URL - базовый URL Tideways API (по умолчанию: https://app.tideways.io/apps/api)
TIDEWAYS_MAX_RETRIES - максимальное количество попыток повтора API-запросов (по умолчанию: 3)
TIDEWAYS_REQUEST_TIMEOUT - таймаут API-запроса в миллисекундах (по умолчанию: 30000)
LOG_LEVEL - уровень логирования (debug, info, warn, error) (по умолчанию: info)

Примеры использования

Какая текущая производительность моего приложения?

Покажи мне недавние ошибки за последние 24 часа

Как работает мой API по сравнению со вчерашним днем?

Какие транзакции сейчас самые медленные?

Проанализируй эндпоинт /api/users/{id} и найди узкие места

Ресурсы

GitHub Repository

Примечания

Это MCP сервер, предназначенный исключительно для AI-ассистентов и не может использоваться как автономный CLI-инструмент. Требует аккаунт Tideways с валидным API-токеном и соответствующими правами доступа (metrics, issues, traces).

Installation

Description