gauge

Gauge

由 Seaynic Labs 打造。 想围绕自己的系统构建这样的工具？我们可以帮您。

Gauge 可以让 AI 助手读取您网站的 Umami 分析数据，并通过 Resend 发送邮件；它还附带了帮助助手做好这些工作的技能：每周报告、文案、SEO 和邮件。

它是一个套件：工具、技能和说明一次安装。工具由多个模块组成，作为一个服务运行。您可以启用所用的模块。新模块默认关闭，因此更新不会改变助手的功能，除非您主动选择启用。

安全卡片
网络	仅连接您配置的服务：您的 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 适用于任何 MCP 客户端：Claude Desktop、Claude Code、Cursor、VS Code、Sonique、Hermes、OpenClaw 等。它在您的计算机上运行，不存储任何内容；您的数据仍保留在 Umami 和 Resend 中。

技能

技能是助手在执行任务前阅读的简短指南。Gauge 附带 9 个技能，基于同一来源提供两种形式：供能够读取 Agent Skills 的应用（Claude Code 等）使用的 skills/ 文件夹，以及供其他所有 MCP 应用使用的 MCP 提示词。

技能	内容	作者
getting-started	设置、首次检查、修复错误	Seaynic Labs
weekly-site-report	一分钟生成 Umami 每周流量报告	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，使用 "servers" 而不是 "mcpServers"
Sonique、Hermes、OpenClaw 等	任何可启动 stdio MCP 服务的客户端：命令为 uvx，参数为 ["gauge-mcp"]，并添加 env 值

通过 HTTP 连接。 对于连接 URL 而不是启动进程的客户端：

gauge-mcp --transport http --port 8765

它会在 http://127.0.0.1:8765/mcp 提供可流式传输的 HTTP 服务。默认情况下，它只监听你自己的计算机。在其他位置公开访问前，请先在其前面配置身份验证。

试试这些

设置好 Gauge 后，将以下任一内容粘贴给助手：

1. “我的网站上周的表现与前一周相比如何？”
2. “这个月哪些页面的访问量最高？这些访问者来自哪里？”
3. “撰写我的每周网站报告，并将其拟为一封发给我的邮件。暂时不要发送。”
4. “审核排名前三的页面的 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 构建。 我们围绕企业自身系统构建此类工具：以本地优先，并由人员审批每项更改。查看定制集成。