jakeyshakey/umami_mcp_server

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。原文を見る

9 stars 6 forks 品質 65 トレンド 17MIT

A Model Context Protocol (MCP) server that enhances Claude's capabilities by providing access to website analytics data from Umami.

概要

A Model Context Protocol (MCP) server that enhances Claude's capabilities by providing access to website analytics data from Umami. This server allows Claude to analyze user behavior, track website performance, and provide data-driven insights. The codebase has been generated from start to finish using Claude Sonnet 3.5 and Cursor. This server connects Claude to your Umami analytics platform, enabling it to: - Analyze user journeys and behavior patterns - Track website performance metrics - Monitor real-time visitor activity - Capture and analyze webpage content - Generate insights from historical analytics data The server provides the following tools to Claude to analyze website data: - : Retrieve a list of websites and their IDs in your Umami account - : Get key metrics like pageviews, visitors, bounce rate for a website - : Analyze specific metrics like URLs, referrers, browsers, countries - : Get time-series pageview data with customizable intervals - : Monitor current number...

README

以下は原文 README の抜粋です。原文を見る。

Umami Analytics MCP Server

A Model Context Protocol (MCP) server that enhances Claude’s capabilities by providing access to website analytics data from Umami. This server allows Claude to analyze user behavior, track website performance, and provide data-driven insights.

The codebase has been generated from start to finish using Claude Sonnet 3.5 and Cursor.

What It Does

This server connects Claude to your Umami analytics platform, enabling it to:

Analyze user journeys and behavior patterns
Track website performance metrics
Monitor real-time visitor activity
Capture and analyze webpage content
Generate insights from historical analytics data

How It Works

The server provides the following tools to Claude to analyze website data:

Available Tools

get_websites: Retrieve a list of websites and their IDs in your Umami account
get_website_stats: Get key metrics like pageviews, visitors, bounce rate for a website
get_website_metrics: Analyze specific metrics like URLs, referrers, browsers, countries
get_pageview_series: Get time-series pageview data with customizable intervals
get_active_visitors: Monitor current number of active visitors on a website
get_session_ids: Retrieve session IDs for specific events or time periods
get_tracking_data: Get detailed activity data for a specific session ID
get_docs: Perform semantic search on many user journeys, returning the most relevant chunks for a given question
get_screenshot: Capture visual snapshots of webpages
get_html: Retrieve and analyze webpage HTML source code

Each tool has a description and a list of arguments that can be passed to it. These are used to provide context and information to allow Claude to effectively select the right tool/s for the job, and provide the correct paremeters.

Most of these tools pull data directly from the Umami API into Claude Desktop, however get_docs adds in a semantic search step to avoid context window issues with Claude as well as saving on token usage. All of the user journeys for a given event are retrieved using the Umami API and then these are chunked into smaller sections and embedded using an open soruce sentence transformer model from hugging face. Then, based on the question, the most relevant chunks are retrieved and returned to Claude, allowing for analysis of specific actions and behaviours performed by users on the website, something hard to replicate with traditional data visualisation tools. The implementation of this embedding and semantic search is in the src/analytics_service/embeddings.py file.

GitHub で README 全文を見る

インストール

This server does not publish a one-line install command.

Open the repository installation guide MCP 初心者？mcpskill.org のガイドから始めましょう →

設定

{
     "mcpServers": {
       "analytics_service": {
         "command": "uv",
         "args": [
           "--directory",
           "/path/to/analytics_service",
           "run",
           "analytics-service"
         ],
         "env": {
          "UMAMI_API_URL": "https://example.com",
          "UMAMI_USERNAME": "yourUmamiUsername",
          "UMAMI_PASSWORD": "yourUmamiPassword", 
          "UMAMI_TEAM_ID": "yourUmamiTeamId"
        }
       }
     }
   }