使用说明

项目简介

Umami Analytics MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在连接 Claude 智能助手与 Umami Analytics 平台。通过此服务器，Claude 可以访问和分析您的网站分析数据，从而提供数据驱动的洞察报告，并支持创建定制化的数据仪表盘。

主要功能点

连接 Umami Analytics: 无缝对接 Umami Analytics 平台，获取网站访问数据。
数据分析工具: 提供一系列工具，包括获取网站统计数据、用户行为指标、页面浏览量、活跃访客信息等，支持 Claude 进行深入分析。
用户行为洞察: 支持用户旅程分析和语义搜索，帮助 Claude 识别用户行为模式和潜在问题。
网页内容获取: 允许 Claude 获取网页截图和 HTML 源代码，为分析网站结构和用户体验提供视觉和结构化信息。
仪表盘创建提示: 内置创建仪表盘的 Prompt 模板，引导 Claude 生成数据可视化方案。

安装步骤

安装 uv: 确保您的系统已安装 'uv' 包管理器，若未安装，请运行命令 'pip install uv' 进行安装。

配置 Claude Desktop:

打开 Claude Desktop 配置文件。
- MacOS: '~/Library/Application Support/Claude/claude_desktop_config.json'
- Windows: '%APPDATA%/Claude/claude_desktop_config.json'

将以下 JSON 配置添加到配置文件中 'mcpServers' 字段，用于注册 'analytics_service' MCP 服务器。

{
  "mcpServers": {
    "analytics_service": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/analytics_service",  // 请替换为您的 analytics_service 目录的实际路径
        "run",
        "analytics-service"
      ],
      "env": {
       "UMAMI_API_URL": "https://example.com",  // 请替换为您的 Umami API URL (自托管或 Umami Cloud)
       "UMAMI_USERNAME": "yourUmamiUsername",  // 请替换为您的 Umami 用户名
       "UMAMI_PASSWORD": "yourUmamiPassword",  // 请替换为您的 Umami 密码
       "UMAMI_TEAM_ID": "yourUmamiTeamId"   // 请替换为您的 Umami 团队 ID
     }
    }
  }
}

请务必根据注释替换上述配置中的占位符，确保路径和 Umami API 凭据正确。

启动 Claude Desktop: 重新打开 Claude Desktop 客户端，它将自动连接到 'analytics_service' MCP 服务器。首次启动可能需要一些时间初始化服务器和安装依赖包。连接成功后，您将在聊天窗口右下方看到一个锤子图标，旁边显示数字 10，表示已加载 10 个 MCP 工具。
(可选) 启用 Analysis tool: 为了更好地利用数据生成仪表盘，建议在 Claude Desktop 的 "Feature Preview" (功能预览) 选项卡中启用 "Analysis tool" (分析工具)。

基本使用方法

使用预置 Prompt: 点击聊天窗口左下角的 "Attach from MCP" (从 MCP 附加) 按钮，选择 "choose implementation" (选择实现)，然后选择 "Create Dashboard Prompt" (创建仪表盘 Prompt)。按照提示输入网站名称、分析的起止日期和时区，服务器将生成仪表盘创建指令，发送到 Claude 后即可自动创建仪表盘。
自然语言交互: 您可以直接在聊天窗口中用自然语言向 Claude 提出关于网站分析的需求，例如 "创建一个关于网站用户行为的仪表盘" 或 "分析最近一周的用户访问来源"。Claude 将自动选择合适的工具来完成您的请求。您也可以通过点击聊天窗口右下角的锤子图标查看所有可用的工具列表。

关键词

使用说明

项目简介

主要功能点

安装步骤

基本使用方法

信息