AI导哈

Umami分析MCP服务器

一个基于Go语言的Model Context Protocol (MCP)服务器，用于将Umami网络分析数据连接到MCP兼容的AI助手，通过自然语言查询分析数据。

  • by kevinastuhuaman
  • Go
  • 本地部署
  • 更新于
在 GitHub 查看 kevinastuhuaman/umami-mcp-server

使用说明

鲜味mcp服务器📈 — 转到MCP服务器进行Umami分析。

用于Umami网络分析的模型上下文协议（MCP）服务器的Go实现。将Claude Code和其他兼容MCP的AI助手直接连接到您的Umami分析数据。问你的人工智能“本周的流量怎么样？”而不是打开仪表板。已发布到Glama.ai和LobeHub注册表。

安装

go install github.com/kevinastuhuaman/umami-mcp-server@latest

添加到MCP客户端配置中（例如，Claude Code settings.json):

{
  "mcpServers": {
    "umami": {
      "command": "umami-mcp-server",
      "env": {
        "UMAMI_URL": "https://your-umami-instance.com",
        "UMAMI_USERNAME": "admin",
        "UMAMI_PASSWORD": "your-password"
      }
    }
  }
}

它做什么

  • 将Umami分析数据暴露给AI助手的MCP服务器
  • 通过自然语言查询页面浏览量、会话、事件和自定义指标
  • 支持日期范围、筛选和聚合
  • 适用于Claude Code、Cursor和任何兼容MCP的客户端
  • 已发布至Glama.ai和LobeHub MCP注册中心

运作原理

MCP client (Claude Code / Cursor)
    |
    v
Connects to umami-mcp-server via stdio
    |
    v
Server translates MCP tool calls to Umami API requests
    |
    v
Returns structured analytics data
    |
    v
AI assistant analyzes and answers questions about your traffic

技术栈

  • 语言： 走
  • 协议： 通过stdio实现模型上下文协议（MCP）
  • API Umami REST API
  • 分布： Go二进制，发布到Glama.ai+LobeHub

我的修复

这是一个定制的叉子 Macawls/umami mcp服务器 有以下改进：

  • 修复了统计API响应解析 -Umami的API为统计数据返回平面整数，而不是嵌套 ValueChange 物体。原始结构反序列化不正确，返回零值。
  • 扩展度量类型 --已添加 path, title, query, channel, domain, region, city, language, screen 度量类型（仅支持原始类型 url +6人）。

我学到了什么

  • MCP非常适合分析——与其构建仪表板，不如问你的人工智能“本周的流量怎么样？”
  • Go的单一二进制发行版使MCP服务器易于部署——没有运行时依赖关系
  • 向MCP注册中心（Glama.ai、LobeHub）发布内容，让我发现了项目，这是我无法从GitHub上获得的

学分

基于 Macawls/umami mcp服务器 --MIT许可证。

相关 MCP