Umami Analytics MCP Server

Overview

基本能力

产品定位

Umami Analytics MCP Server 是一个连接 Claude 和 Umami 分析平台的桥梁，提供网站数据分析能力。

核心功能

分析用户旅程和行为模式
跟踪网站性能指标
监控实时访客活动
捕获和分析网页内容
从历史分析数据生成见解

适用场景

网站性能优化
用户行为分析
实时访客监控
数据驱动的决策支持

工具列表

get_websites: 获取 Umami 账户中的网站列表及其 ID
get_website_stats: 获取关键指标（如页面浏览量、访客数、跳出率）
get_website_metrics: 分析特定指标（如 URL、引荐来源、浏览器、国家）
get_pageview_series: 获取可自定义时间间隔的页面浏览时间序列数据
get_active_visitors: 监控网站上当前活跃访客数量
get_session_ids: 检索特定事件或时间段的会话 ID
get_tracking_data: 获取特定会话 ID 的详细活动数据
get_docs: 对多个用户旅程进行语义搜索，返回最相关的片段
get_screenshot: 捕获网页的视觉快照
get_html: 检索和分析网页 HTML 源代码

常见问题解答

服务器初始化可能需要几分钟时间
建议启用 Claude Desktop 中的"Analysis tool"功能以获得最佳体验
屏幕截图会被降采样以避免上下文窗口问题

使用教程

使用依赖

安装 uv: pip install uv

安装教程

配置 Claude Desktop 配置文件（MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json，Windows: %APPDATA%/Claude/claude_desktop_config.json）
添加以下配置：

{
  "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"
      }
    }
  }
}

替换路径和 Umami 凭证信息

调试方式

打开 Claude Desktop，服务器将自动连接
等待服务器初始化完成（可能需要几分钟）
检查右下角的工具图标，确认10个工具可用
使用"Create Dashboard Prompt"开始分析
通过自然语言与 Claude 交互，请求特定数据分析

高级使用

创建自定义提示：
在 src/analytics_service/server.py 中定义提示结构
实现提示处理逻辑
遵循最佳实践创建有效的提示
使用不同角色和内容类型构建结构化对话流
利用资源类型处理复杂数据

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。