Skip to main content
Glama
Sign In
deenesjakoruzh
Umami MCP Server

Umami MCP Server

by Macawls
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Go
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

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

    ActivityInactive
    ResponsivenessLimited 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