Skip to main content
Glama
Sign In
deenesjakoruzh
Umami MCP Server

Umami MCP Server

by Macawls
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Go
Remote

Umami MCP 服务器

将您的 Umami Analytics 连接到任何 MCP 客户端 - Claude Desktop、VS Code、Cursor、Windsurf、Zed、Smithery 等。

提示词

分析与流量

  • "给我一份过去 30 天我网站的综合分析报告"

  • "本月哪些页面的流量最高？显示前 10 名"

  • "分析我网站的流量模式 - 我在什么时候访问量最大？"

用户洞察

  • "我的访客来自哪里？按国家和城市细分"

  • "我的用户正在使用什么设备和浏览器？"

  • "向我展示用户旅程 - 访客通常按什么顺序查看页面？"

实时监控

  • "现在有多少人在我的网站上？他们正在查看哪些页面？"

  • "我的网站是否有问题？检查流量是否大幅下降"

内容与营销活动分析

  • "我应该更新哪些博客文章？显示流量下降的文章"

  • "我最近的电子邮件营销活动表现如何？追踪来自营销活动 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。直接从任何支持 HTTP 传输的 MCP 客户端连接 - 无需二进制文件或 Docker。

凭据通过 initialize 请求上的 X-Umami-* 标头传递。

添加到您的配置中（Windows 上为 %APPDATA%\Claude\claude_desktop_config.json，macOS 上为 ~/Library/Application Support/Claude/claude_desktop_config.json）：

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

任何支持 Streamable HTTP 的 MCP 客户端都可以连接到 https://umami-mcp.macawls.dev/mcp，并在 X-Umami-Host、X-Umami-Username 和 X-Umami-Password 标头中包含凭据。

本地

在本地运行二进制文件或 Docker 镜像。凭据通过环境变量设置。

添加到您的配置中（Windows 上为 %APPDATA%\Claude\claude_desktop_config.json，macOS 上为 ~/Library/Application Support/Claude/claude_desktop_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"
      }
    }
  }
}

创建 .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

必填

您的 Umami 实例 URL（Umami Cloud 请使用 https://api.umami.is）

UMAMI_USERNAME

自托管必填

Umami 用户名

UMAMI_PASSWORD

自托管必填

Umami 密码

UMAMI_API_KEY

Umami Cloud 必填

来自您 Umami Cloud 账户的 API 密钥（用户名/密码的替代方案）

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 Cloud，请改用 API 密钥：

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

环境变量的优先级高于配置文件。

Umami Cloud

Umami Cloud（托管版本 cloud.umami.is）不支持用户名/密码身份验证。请使用您 Umami Cloud 账户设置中的 API 密钥，并将 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 标头。

您可以在 Umami 仪表板的 设置 > 团队 下找到您的团队 ID。

自托管 (HTTP 传输)

该服务器支持用于远程部署的 Streamable HTTP。设置 TRANSPORT=http 以公开 /mcp 端点：

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

凭据通过 initialize 请求上的 X-Umami-* 标头传递。响应包含用于后续请求的 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

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    This server cannot be deployed

    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Resources

    Related MCP Connectors

    Related MCP Servers

    • Umami Analytics MCP Server

      jakeyShakey
      A
      license
      Not graded
      quality
      D
      maintenance
      Enhances Claude's capabilities by providing access to website analytics data from Umami, enabling analysis of user behavior, website performance tracking, and data-driven insights generation.
      9
      MIT

    • umami-mcp-server

      MurkyPuma
      A
      license
      A
      quality
      C
      maintenance
      An MCP server that gives Claude read access to Umami web analytics, allowing natural language queries for stats, breakdowns, pageview trends, live visitors, and user journeys.
      10
      1
      MIT

    • umami-mcp-server

      frontedu
      A
      license
      Not graded
      quality
      D
      maintenance
      MCP server for Umami Analytics that provides read-only tools to query website stats, events, sessions, reports, and more, enabling natural language analytics queries.
      24 npm
      3
      MIT