Umami MCP Server

Name: Umami MCP Server
Author: Macawls

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

Промпты

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

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

Инсайты о пользователях

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

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

"Сколько людей сейчас на моем сайте? Какие страницы они просматривают?"
"Есть ли на моем сайте какие-либо проблемы? Проверь, не упал ли трафик значительно"

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

"Какие посты в блоге стоит обновить? Покажи статьи со снижающимся трафиком"
"Как сработала моя недавняя email-кампания? Отследи посетителей по UTM-меткам кампании"
"Сравни трафик с различных платформ социальных сетей"

Related MCP server: Customized 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"
      }
    }
  }
}

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

Инструмент	Описание
`get_websites`	Список всех сайтов (вызовите первым, чтобы получить ID сайтов)
`get_stats`	Агрегированная статистика — просмотры страниц, посетители, отказы, общее время
`get_pageviews`	Количество просмотров страниц и сессий, сгруппированных по единицам времени
`get_metrics`	Разбивка по страницам, реферерам, браузерам, ОС, устройствам, странам и т.д.
`get_active`	Текущее количество активных посетителей в реальном времени

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

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

Переменная	По умолчанию	Описание
`UMAMI_URL`	обязательно	URL вашего экземпляра Umami
`UMAMI_USERNAME`	обязательно	Имя пользователя Umami
`UMAMI_PASSWORD`	обязательно	Пароль Umami
`UMAMI_TEAM_ID`		ID команды для командных настроек
`TRANSPORT`	`stdio`	Режим транспорта (`stdio` или `http`)
`PORT`	`8080`	Порт HTTP-сервера
`ALLOWED_ORIGINS`	`*`	Разрешенные источники CORS через запятую
`MAX_SESSIONS`	`1000`	Максимальное количество одновременных HTTP-сессий

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

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

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

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

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

Если ваш экземпляр 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

Umami MCP Server

Umami MCP Server

Промпты

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

Инсайты о пользователях

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

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

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

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

Вариант 2: Docker

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

Настройка

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

Локально

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

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

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

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

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

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

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

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

Лицензия

Resources

Latest Blog Posts

MCP directory API