gauge

Gauge

Seaynic Labs 製。 このようなツールをお客様のシステムに合わせて開発したい場合は、こちらをご覧ください。

Gauge を使うと、AI アシスタントはウェブサイトの Umami アナリティクスを読み取り、Resend でメールを送信できます。また、週次レポート、コピー、SEO、メールなどの作業を適切に行えるようにするスキルも付属しています。

Gauge はツール、スキル、指示をひとつにまとめたバンドルです。ツールはモジュールで構成されたひとつのサーバーです。使用するモジュールを有効にします。新しいモジュールは無効の状態で追加されるため、自分で選ぶまでは、更新によってアシスタントができることが変わることはありません。

セキュリティ情報
ネットワーク	設定したサービスのみです。Umami のアドレス（または api.umami.is）と api.resend.com に接続します。それ以外への接続やテレメトリーはありません。
ファイル	設定ファイル（/.config/gauge/config.toml）を読み取ります。ローカルの承認ログ（/.local/state/gauge/approvals.jsonl）をひとつ書き込みます。
シークレット	API キーとパスワードは環境変数または設定ファイルから取得します。ツールの引数として渡されることも、モデルに返されることもありません。
読み取り専用ツール	7 個：umami_websites、umami_stats、umami_pageviews、umami_metrics、resend_emails、resend_domains、gauge_modules
承認が必要	resend_send：アプリで送信ごとに承認するか、設定で受信者を事前承認します。AI がユーザーの代わりに承認することはできません。
起動時のコスト	約 4,700 トークン（8 個のツール、9 個のスキルプロンプト）
変更	ツールの説明はハッシュでロックされています（tool-manifest.lock.json）。説明が予告なく変更された場合、CI は失敗します。

モジュール	機能	ステータス
umami	Umami のウェブアナリティクス。セルフホスト版または Umami Cloud に対応し、サイト、合計値、時系列データ、人気のページ、参照元、国、ブラウザーを取得します。	0.1
resend	Resend によるメール機能。送信（事前にプレビュー）、送信済みメールの一覧表示、送信ドメインの一覧表示に対応します。	0.1

Gauge は、Claude Desktop、Claude Code、Cursor、VS Code、Sonique、Hermes、OpenClaw など、あらゆる MCP クライアントで使用できます。お使いのコンピューター上で動作し、データは保存しません。データは Umami と Resend に保持されます。

スキル

スキルは、作業を行う前にアシスタントが読む短いガイドです。Gauge には、ひとつのソースから生成した 2 種類の形式で、9 個のスキルが付属します。Agent Skills を読み取るアプリ（Claude Code など）向けの skills/ フォルダーと、それ以外のすべての MCP アプリ向けの MCP プロンプトです。

スキル	内容	作成者
getting-started	セットアップ、最初の確認、エラーの修正	Seaynic Labs
weekly-site-report	Umami を使った 1 分で読める週次トラフィックレポート	Seaynic Labs
analytics、seo-audit、copywriting、emails	トラッキング計画、SEO 監査、ページのコピー、メールシーケンス	Corey Haines、MIT
resend、email-best-practices、react-email	Resend での送信、到達率、HTML メール	Resend、MIT

サードパーティ製スキルのライセンスは引き続き適用されます。CREDITS.md をご覧ください。

インストール

Gauge には Python 3.11 以降が必要です。uv を使えば、事前に何もインストールする必要はありません。

uvx gauge-mcp --version
uvx gauge-mcp --doctor          # checks your settings and connections, prints fixes

更新を自分で選んだときだけ適用したい場合は、正確なバージョンを指定します：uvx gauge-mcp==0.2.1。

または pip を使用します：

pip install gauge-mcp

Claude Code プラグインとして（ツールとスキルをまとめて導入）：

/plugin marketplace add seayniclabs/plugins
/plugin install gauge@seayniclabs

プラグインを使用する場合は、設定を ~/.config/gauge/config.toml に記述します（以下を参照）。

設定

MCP クライアントの設定で環境変数として設定するか、設定ファイルに記述します（下記を参照）。使用するモジュールに必要な設定だけでかまいません。Gauge はこれらの設定がなくても起動し、ツールの呼び出し時に不足している項目を知らせます。

変数	モジュール	内容
GAUGE_UMAMI_URL	umami	Umami のアドレス（例：https://analytics.example.com）
GAUGE_UMAMI_USERNAME / GAUGE_UMAMI_PASSWORD	umami	セルフホスト版 Umami のログイン情報です。閲覧専用ユーザーで十分です。
GAUGE_UMAMI_API_KEY	umami	Umami Cloud の API キーです（ログイン情報の代わりに使用）。これを設定すると、GAUGE_UMAMI_URL のデフォルトは Umami Cloud になります。
GAUGE_RESEND_API_KEY	resend	Resend の API キー
GAUGE_RESEND_FROM	resend	Resend で認証済みのドメインの送信元アドレス
GAUGE_RESEND_FROM_NAME	resend	任意の送信者表示名
GAUGE_RESEND_ALLOWED_RECIPIENTS	resend	任意。アシスタントが毎回確認せずに送信できる、カンマ区切りのアドレスまたは @domains。例：[email protected],@example.com
GAUGE_RESEND_REQUIRE_CONFIRM	resend	デフォルトは true で、送信ごとに承認します。false にすると、アシスタントが独自に送信します。
GAUGE_<MODULE>_ENABLED	任意	false にするとモジュールが無効になります。例：GAUGE_RESEND_ENABLED=false

設定ファイル（任意）。 Gauge は ~/.config/gauge/config.toml、または GAUGE_CONFIG で指定したファイルも読み込みます。環境変数は設定ファイルより優先されます。

[umami]
url = "https://analytics.example.com"
username = "viewer"
password = "change-me"

[resend]
enabled = false

MCP クライアントに追加する

ほとんどのクライアントで同じ JSON 形式を使用します。クライアントで MCP サーバーを設定する場所に記述してください。

{
  "mcpServers": {
    "gauge": {
      "command": "uvx",
      "args": ["gauge-mcp"],
      "env": {
        "GAUGE_UMAMI_URL": "https://analytics.example.com",
        "GAUGE_UMAMI_USERNAME": "viewer",
        "GAUGE_UMAMI_PASSWORD": "change-me",
        "GAUGE_RESEND_API_KEY": "re_your_key",
        "GAUGE_RESEND_FROM": "[email protected]"
      }
    }
  }
}

クライアント	設定の場所
Claude Desktop	claude_desktop_config.json（Settings → Developer → Edit Config）
Claude Code	claude mcp add gauge -- uvx gauge-mcp を実行してから env の値を追加するか、プロジェクトの .mcp.json に設定します
Cursor	~/.cursor/mcp.json、またはプロジェクト内の .cursor/mcp.json
VS Code	.vscode/mcp.json。"mcpServers" の代わりに "servers" を使用します
Sonique、Hermes、OpenClaw など	stdio MCP サーバーを起動する任意のクライアント：コマンドは uvx、引数は ["gauge-mcp"]、さらに env の値を指定します

HTTP 経由。 プロセスを起動するのではなく、URL に接続するクライアントの場合：

gauge-mcp --transport http --port 8765

ストリーミング可能な HTTP を http://127.0.0.1:8765/mcp で提供します。デフォルトでは、お使いのマシンからのみ接続を受け付けます。それ以外の場所に公開する前に、認証を設定してください。

試してみる

Gauge のセットアップ後、次のいずれかをアシスタントに入力してください。

1. 「先週のサイトの実績を、その前の週と比較するとどうでしたか？」
2. 「今月、最もアクセス数の多かったページと、その訪問者の流入元を教えてください。」
3. 「週次のサイトレポートを作成し、私宛てのメールの下書きにしてください。まだ送信しないでください。」
4. 「上位3ページの SEO を監査し、新しいタイトルと説明文を提案してください。」
5. 「Resend の送信ドメインのうち、まだ認証されていないものと、修正が必要な点を教えてください。」

ツール

ツール	返される内容
gauge_modules	有効なモジュール、不足している設定、各ツールの機能を確認できます。最初に呼び出してください。
umami_websites	ページ分割されたトラッキング対象のウェブサイト
umami_stats	日付範囲内のページビュー、訪問者数、訪問数、直帰数、直帰率
umami_pageviews	時系列のページビューとセッション数
umami_metrics	順位付きの内訳。type には path（上位ページ）、referrer、country、browser、os、device などを指定します
resend_send	承認後にメールを送信します。confirm=true を指定しない場合は、プレビューのみを返します。
resend_emails	カーソルを使ってページ分割された送信済みメール
resend_domains	送信ドメインと、それぞれの認証状況

各ツールは公開されたスキーマを備えた構造化データを返すため、アシスタントはテキストを読む代わりに、結果を使うコードを記述できます。日付範囲には days（デフォルトは 7）または ISO 8601 形式の start と end を指定します。エラーは常に gauge.<module>.<code>: <message> Fix: <hint> の形式です。

安全性

• Gauge は、設定したサービスのみを呼び出します。それ以外の場所には何も送信せず、データも保持しません。
• resend_send は実際のメールを送信するため、送信を承認するのはアシスタントではなく、あなたです。アシスタントが送信を依頼すると、Gauge は MCP クライアント（MCP elicitation）を通じてあなたに直接確認し、送信者、宛先、件名を表示します。アシスタントがあなたに代わってその質問に答えることはできません。
• 一部の MCP クライアントは、まだ質問を送ることができません。その場合、GAUGE_RESEND_ALLOWED_RECIPIENTS で宛先を事前承認するか、GAUGE_RESEND_REQUIRE_CONFIRM=false で確認を無効にしない限り、Gauge は送信を拒否します。
• Gauge に付与するアクセス権は、必要最小限にしてください。Umami の読み取り専用ユーザーを使用し、他のメールツールが不要であれば、送信のみに制限した Resend キーを使用してください。

開発

uv venv && uv pip install -e '.[dev]'
.venv/bin/pytest

セキュリティ

脆弱性は GitHub から非公開で報告してください（Security タブの「Report a vulnerability」）。SECURITY.md をご覧ください。あなたが承認または拒否した送信、および拒否された送信はすべて、ローカルの ~/.local/state/gauge/approvals.jsonl に記録されます（宛先と件名。メッセージ本文は記録されません）。保存先を変更するには、GAUGE_APPROVAL_LOG を設定してください。

ライセンス

MIT。Seaynic Labs が公開しています。サードパーティ製スキルは CREDITS.md にクレジットを記載しており、それぞれ独自のライセンスが適用されます。

---

Seaynic Labs が開発しています。 私たちは、ビジネス独自のシステムを基盤としたこのようなツールを開発しています。ローカル優先で、変更のたびに人が承認します。カスタム統合をご覧ください。