climactic/umami-mcp

开发工具

本页由 AI 翻译，技术细节请以原文为准。查看原文

6 stars 4 forks 质量 64 趋势 14MIT

Repository Install

Umami Analytics MCP - No Binaries, No Docker, Easy to Use

概览

An MCP server for Umami Analytics that gives Claude (and any MCP-compatible client) full read/write access to your analytics data. Works with both Umami Cloud and self-hosted instances. 48 tools covering websites, stats, pageviews, metrics, sessions, events, reports (funnel, retention, goals, journey, attribution, UTM, revenue, performance, breakdown), teams, and user admin. - umami_whoami — Current authenticated user - umami_list_my_websites — Websites accessible to current user - umami_list_websites — List all websites - umami_get_website — Get website details - umami_create_website — Create a new website - umami_update_website — Update name/domain/shareId - umami_delete_website — Delete a website permanently - umami_reset_website — Wipe all data for a website - umami_get_stats — Aggregate stats (pageviews, visitors, bounces, time) - umami_get_pageviews — Pageviews + sessions time series - umami_get_metrics — Top N by dimension (url, referrer, browser, os, country, event, ...

README

以下为原文 README 节选，完整内容请查看原文。

@climactic/umami-mcp

An MCP server for Umami Analytics that gives Claude (and any MCP-compatible client) full read/write access to your analytics data. Works with both Umami Cloud and self-hosted instances.

48 tools covering websites, stats, pageviews, metrics, sessions, events, reports (funnel, retention, goals, journey, attribution, UTM, revenue, performance, breakdown), teams, and user admin.

Install

Claude Code (plugin)

# Add the marketplace and install
claude /plugin marketplace add climactic/umami-mcp
claude /plugin install umami-mcp@climactic

Claude Desktop / other MCP clients

Add to your mcpServers config:

{
  "mcpServers": {
    "umami": {
      "command": "bunx",
      "args": ["@climactic/umami-mcp"],
      "env": {
        "UMAMI_API_KEY": "your-api-key"
      }
    }
  }
}

Local dev

git clone https://github.com/climactic/umami-mcp.git
cd umami-mcp
bun install
UMAMI_API_KEY=your-key bun run index.ts

Auth

Set one of these env var combinations:

Umami Cloud:

Variable	Required	Description
`UMAMI_API_KEY`	Yes	API key from Umami Cloud dashboard
`UMAMI_BASE_URL`	No	Override API base (default: `https://api.umami.is/v1`)
`UMAMI_DEFAULT_WEBSITE_ID`	No	Default website UUID for tools that accept `websiteId`

Self-hosted:

Variable	Required	Description
`UMAMI_BASE_URL`	Yes	Your Umami instance URL, e.g. `https://umami.example.com`
`UMAMI_USERNAME`	Yes	Admin username
`UMAMI_PASSWORD`	Yes	Admin password
`UMAMI_DEFAULT_WEBSITE_ID`	No	Default website UUID

Tools

在 GitHub 查看完整 README

安装

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

Open the repository installation guide 新手？先看 mcpskill.org 教程 →

配置

{
  "mcpServers": {
    "umami": {
      "command": "bunx",
      "args": ["@climactic/umami-mcp"],
      "env": {
        "UMAMI_API_KEY": "your-api-key"
      }
    }
  }
}