Umami MCP Server

Подключите свою аналитику Umami к любому MCP-клиенту — Claude Desktop, VS Code, Cursor, Windsurf, Zed, Smithery и другим.

Промпты

Аналитика и трафик

• "Составь подробный отчет по аналитике моего сайта за последние 30 дней"

• "Какие страницы получают больше всего трафика в этом месяце? Покажи топ-10"

• "Проанализируй паттерны трафика моего сайта — когда у меня больше всего посетителей?"

Анализ пользователей

• "Откуда приходят мои посетители? Разбей данные по странам и городам"

• "Какие устройства и браузеры используют мои пользователи?"

• "Покажи путь пользователя — какие страницы посетители обычно просматривают последовательно?"

Мониторинг в реальном времени

• "Сколько людей сейчас на моем сайте? Какие страницы они просматривают?"

• "Есть ли проблемы с моим сайтом? Проверь, не упал ли трафик значительно"

Анализ контента и кампаний

• "Какие записи в блоге стоит обновить? Покажи статьи с падающим трафиком"

• "Как сработала моя недавняя email-кампания? Отследи посетителей по UTM-меткам кампании"

• "Сравни трафик с различных платформ социальных сетей"

Related MCP server: Umami MCP Server

Быстрый старт

Вариант 1: Скачать бинарный файл

Получите последний релиз для вашей платформы в разделе Releases

Вариант 2: Docker

docker run -i --rm \
  -e UMAMI_URL="https://your-instance.com" \
  -e UMAMI_USERNAME="username" \
  -e UMAMI_PASSWORD="password" \
  ghcr.io/macawls/umami-mcp-server

Вариант 3: Установка через Go

go install github.com/Macawls/umami-mcp-server@latest

Устанавливается в ~/go/bin/umami-mcp-server (или $GOPATH/bin)

Настройка

Выберите один из двух подходов ниже в зависимости от ваших предпочтений.

Удаленный (без установки)

Хостинговый экземпляр доступен по адресу https://umami-mcp.macawls.dev/mcp. Подключайтесь напрямую из любого MCP-клиента, поддерживающего HTTP-транспорт — бинарный файл или Docker не требуются.

Учетные данные передаются через заголовки X-Umami-* в запросе initialize.

Добавьте в свой конфиг (%APPDATA%\Claude\claude_desktop_config.json в Windows, ~/Library/Application Support/Claude/claude_desktop_config.json в macOS):

{
  "mcpServers": {
    "umami": {
      "type": "http",
      "url": "https://umami-mcp.macawls.dev/mcp",
      "headersHelper": "echo X-Umami-Host: https://your-instance.com && echo X-Umami-Username: admin && echo X-Umami-Password: pass"
    }
  }
}

Добавьте в .vscode/mcp.json:

{
  "servers": {
    "umami": {
      "type": "http",
      "url": "https://umami-mcp.macawls.dev/mcp",
      "headers": {
        "X-Umami-Host": "https://your-instance.com",
        "X-Umami-Username": "${input:umami-username}",
        "X-Umami-Password": "${input:umami-password}"
      }
    }
  }
}

claude mcp add --transport http \
  --header "X-Umami-Host: https://your-instance.com" \
  --header "X-Umami-Username: admin" \
  --header "X-Umami-Password: pass" \
  umami https://umami-mcp.macawls.dev/mcp

Добавьте в .cursor/mcp.json:

{
  "mcpServers": {
    "umami": {
      "url": "https://umami-mcp.macawls.dev/mcp",
      "headers": {
        "X-Umami-Host": "https://your-instance.com",
        "X-Umami-Username": "admin",
        "X-Umami-Password": "pass"
      }
    }
  }
}

Добавьте в ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "umami": {
      "serverUrl": "https://umami-mcp.macawls.dev/mcp",
      "headers": {
        "X-Umami-Host": "https://your-instance.com",
        "X-Umami-Username": "admin",
        "X-Umami-Password": "pass"
      }
    }
  }
}

Добавьте в opencode.json:

{
  "mcp": {
    "umami": {
      "type": "remote",
      "url": "https://umami-mcp.macawls.dev/mcp",
      "headers": {
        "X-Umami-Host": "https://your-instance.com",
        "X-Umami-Username": "admin",
        "X-Umami-Password": "pass"
      }
    }
  }
}

Любой MCP-клиент, поддерживающий Streamable HTTP, может подключиться к https://umami-mcp.macawls.dev/mcp с учетными данными в заголовках X-Umami-Host, X-Umami-Username и X-Umami-Password.

Локальный

Запустите бинарный файл или Docker-образ локально. Учетные данные задаются через переменные окружения.

Добавьте в свой конфиг (%APPDATA%\Claude\claude_desktop_config.json в Windows, ~/Library/Application Support/Claude/claude_desktop_config.json в macOS):

{
  "mcpServers": {
    "umami": {
      "command": "~/go/bin/umami-mcp-server",
      "env": {
        "UMAMI_URL": "https://your-umami-instance.com",
        "UMAMI_USERNAME": "your-username",
        "UMAMI_PASSWORD": "your-password"
      }
    }
  }
}

Создайте .vscode/mcp.json:

{
  "servers": {
    "umami": {
      "command": "~/go/bin/umami-mcp-server",
      "env": {
        "UMAMI_URL": "https://your-umami-instance.com",
        "UMAMI_USERNAME": "your-username",
        "UMAMI_PASSWORD": "your-password"
      }
    }
  }
}

claude mcp add \
  umami-mcp-server \
  -e UMAMI_URL="https://your-umami-instance.com" \
  -e UMAMI_USERNAME="your-username" \
  -e UMAMI_PASSWORD="your-password" \
  -- ~/go/bin/umami-mcp-server

Добавьте в .cursor/mcp.json:

{
  "mcpServers": {
    "umami": {
      "command": "~/go/bin/umami-mcp-server",
      "env": {
        "UMAMI_URL": "https://your-umami-instance.com",
        "UMAMI_USERNAME": "your-username",
        "UMAMI_PASSWORD": "your-password"
      }
    }
  }
}

Добавьте в ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "umami": {
      "command": "~/go/bin/umami-mcp-server",
      "env": {
        "UMAMI_URL": "https://your-umami-instance.com",
        "UMAMI_USERNAME": "your-username",
        "UMAMI_PASSWORD": "your-password"
      }
    }
  }
}

Добавьте в настройки Zed в разделе assistant.mcp_servers:

{
  "umami": {
    "command": "~/go/bin/umami-mcp-server",
    "env": {
      "UMAMI_URL": "https://your-umami-instance.com",
      "UMAMI_USERNAME": "your-username",
      "UMAMI_PASSWORD": "your-password"
    }
  }
}

Для клиентов, использующих поле command (Claude Desktop, Cursor и т.д.):

{
  "mcpServers": {
    "umami": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "UMAMI_URL",
        "-e", "UMAMI_USERNAME",
        "-e", "UMAMI_PASSWORD",
        "ghcr.io/macawls/umami-mcp-server"
      ],
      "env": {
        "UMAMI_URL": "https://your-umami-instance.com",
        "UMAMI_USERNAME": "your-username",
        "UMAMI_PASSWORD": "your-password"
      }
    }
  }
}

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

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

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

Файл конфигурации

Вместо переменных окружения создайте файл config.yaml рядом с бинарным файлом:

umami_url: https://your-umami-instance.com
username: your-username
password: your-password
team_id: your-team-id  # optional

Для Umami Cloud используйте API-ключ:

umami_url: https://api.umami.is
api_key: your-api-key

Переменные окружения имеют приоритет над файлом конфигурации.

Umami Cloud

Umami Cloud (хостинговая версия на cloud.umami.is) не поддерживает аутентификацию по имени пользователя/паролю. Используйте API-ключ из настроек вашего аккаунта Umami Cloud и установите UMAMI_URL=https://api.umami.is вместе с UMAMI_API_KEY=.... Для HTTP-транспорта отправляйте заголовок X-Umami-Api-Key вместо X-Umami-Username/X-Umami-Password.

Командные сайты

Если ваш экземпляр Umami использует команды, и ваши сайты назначены команде, а не отдельным пользователям, get_websites может вернуть пустой список. Установите UMAMI_TEAM_ID, чтобы получать сайты вашей команды. Для HTTP-транспорта используйте заголовок X-Umami-Team-Id.

Вы можете найти ID своей команды в панели управления Umami в разделе Settings > Teams.

Self-Hosting (HTTP-транспорт)

Сервер поддерживает Streamable HTTP для удаленных развертываний. Установите TRANSPORT=http для открытия эндпоинта /mcp:

TRANSPORT=http PORT=9999 ./umami-mcp-server

Учетные данные передаются через заголовки X-Umami-* в запросе initialize. Ответ включает заголовок Mcp-Session-Id для последующих запросов.

Docker по умолчанию использует HTTP-режим:

docker run -p 8080:8080 ghcr.io/macawls/umami-mcp-server

Сборка из исходного кода

git clone https://github.com/Macawls/umami-mcp-server.git
cd umami-mcp-server
go build -o umami-mcp

Устранение неполадок

• Бинарный файл macOS не запускается: xattr -c umami-mcp-server для снятия карантина

• Бинарный файл Linux не запускается: chmod +x umami-mcp-server

• Ошибки подключения: Проверьте, доступен ли ваш экземпляр Umami и верны ли учетные данные

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

Лицензия

MIT