de en es ja ko ru zh

Umami MCP Server

Name: Umami MCP Server
Author: Macawls

by Macawls

Overview Schema Source Related Servers Discussions Admin

Remote

Umami MCP Server

Umami AnalyticsをClaude Desktop、VS Code、Cursor、Windsurf、Zed、SmitheryなどのあらゆるMCPクライアントに接続します。

プロンプト

分析とトラフィック

"過去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）にインストールされます。

セットアップ

好みに応じて、以下の2つのアプローチから1つを選択してください。

リモート（インストール不要）

ホストされたインスタンスが 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クライアントであれば、X-Umami-Host、X-Umami-Username、X-Umami-Password ヘッダーに認証情報を含めて https://umami-mcp.macawls.dev/mcp に接続できます。

ローカル

バイナリまたは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`	ページ、リファラー、ブラウザ、OS、デバイス、国別の内訳
`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-Username/X-Umami-Password の代わりに X-Umami-Api-Key ヘッダーを送信してください。

チームのウェブサイト

Umamiインスタンスでチームを使用しており、ウェブサイトが個々のユーザーではなくチームに割り当てられている場合、get_websites が空のリストを返すことがあります。UMAMI_TEAM_ID を設定して、チームからウェブサイトを取得してください。HTTPトランスポートの場合は、X-Umami-Team-Id ヘッダーを使用します。

チームIDは、Umamiダッシュボードの Settings > Teams で確認できます。

セルフホスト (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

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

ActivitySlowing

ResponsivenessWithin a week

Resources

GitHub Repository

Need Help?

Related Servers

Related MCP Connectors

QuallaaOAuth
com.quallaa
Talk to your public-facing AI from any MCP client — Claude, ChatGPT, Cursor, Cline, Windsurf.
AI & Machine Learning Communication
2
nexsusOAuth
io.github.dbnexsus
Private persistent memory for Claude, ChatGPT & Gemini via MCP - semantic search, zero-code setup.
Knowledge & Memory RAG Systems
2
Agent AnalyticsOAuth
io.github.dannyshmueli
Analytics your AI agent can actually use. Track, experiment, and optimize via MCP.
Agent Orchestration Monitoring
2
mcpOAuth
ai.butlerbrain
Persistent memory for AI assistants. Save once; recall from Claude, ChatGPT, or any MCP client.
Knowledge & Memory RAG Systems Workplace & Productivity
2

Related MCP Servers

Umami Analytics MCP Server
Monitoring Web Scraping Search
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.
Updated 2 years ago (2025-03-06 11:37 UTC)
9
MIT
Umami MCP Server
Marketing Search
Alurith
A
license
C
quality
B
maintenance
MCP server exposing Umami analytics (Cloud + self-hosted)
Updated a month ago (2026-08-25 15:28 UTC)
5
MIT
umami-mcp-server
Monitoring Observability
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.
Updated 2 months ago (2026-07-20 17:57 UTC)
10
1
MIT
umami-mcp-server
Monitoring Observability
frontedu
A
license
Not graded
quality
C
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.
Updated 2 months ago (2026-07-18 15:19 UTC)
12 npm
3
MIT

Umami MCP Server

プロンプト

分析とトラフィック

ユーザーインサイト

リアルタイム監視

コンテンツとキャンペーンの分析

クイックスタート

オプション1: バイナリのダウンロード

オプション2: Docker

オプション3: Goのインストール

セットアップ

リモート（インストール不要）

ローカル

利用可能なツール

設定

環境変数

設定ファイル

Umami Cloud

チームのウェブサイト

セルフホスト (HTTPトランスポート)

ソースからのビルド

トラブルシューティング

ライセンス

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

Umami Analytics MCP Server

Umami MCP Server

umami-mcp-server

umami-mcp-server