Statable

Statable MCP 服务

向你的 AI 助手询问网站流量情况。此软件包可将 Claude、Cursor、ChatGPT、Claude Desktop 和其他任何 MCP 客户端连接到 Statable。Statable 是一项以隐私为先、无需 Cookie、托管在欧盟的 Web 分析服务。

这是一个精简的 stdio 桥接程序，可连接到托管的 Statable MCP 端点（https://mcp.statable.com/mcp）。每次工具调用都会连同你的 API 密钥一起转发到该端点。本地不会存储任何内容。

连接方式

你的客户端	使用方式
Claude Code、Cursor、ChatGPT、Codex 和其他支持 OAuth 的客户端	直接连接到 https://mcp.statable.com/mcp，并在浏览器中登录。无需密钥，也无需安装软件包。请参阅文档。
Claude Desktop、仅运行本地 stdio 服务的宿主、CI 脚本、沙盒	使用带 API 密钥的此软件包。

快速开始

1. 在 Statable 控制面板中打开 Settings → API keys → Create API key。密钥以 stbl_ 开头。选择助手可以使用的网站和权限。
2. 将服务添加到客户端。Claude Desktop（claude_desktop_config.json）：

{
  "mcpServers": {
    "statable": {
      "command": "npx",
      "args": ["-y", "@statable/mcp"],
      "env": { "STATABLE_API_KEY": "stbl_your_key" }
    }
  }
}

Cursor（~/.cursor/mcp.json）和大多数其他宿主也接受相同的格式。

Claude Code：

claude mcp add statable --scope user -e STATABLE_API_KEY=stbl_your_key -- npx -y @statable/mcp

3. 询问：“example.com 上周有多少访客，他们来自哪里？”

工具（25 个）

读取：list_sites、query_stats、top_pages、top_sources、top_countries、top_custom_events、top_goals、list_goals、list_prop_keys、list_funnels、funnel_report、current_visitors、visitors_over_time、get_tracking_snippet、get_site_filters、get_subscription

设置：create_site、update_site、create_goal、update_goal、create_funnel、update_funnel、get_tracking_settings、update_tracking_settings、update_site_filters

query_stats 是通用工具：可针对任意指标（访客数、页面浏览量、跳出率、参与度、目标、退出率等）、任意维度（来源、页面、国家/地区、设备、UTM、自定义事件属性等）和筛选条件，查询汇总数据、时间序列或前 N 项细分，并进行周期对比。所有数字均以网站自身时区返回。完整参考文档：statable.com/docs/integrations/mcp。

写入工具仅会修改配置（网站、目标、漏斗、跟踪功能、筛选条件）。不会删除任何数据。

Agent 技能

此仓库也可作为 Claude Code 插件使用：包含托管的 MCP 服务（.mcp.json，OAuth）和三个技能。

技能	功能
statable	审核你的代码库或线上网站，提出测量计划（目标、漏斗、自定义事件、属性、跟踪器功能），并在你批准后，在代码和 Statable 账户中实施，然后检查数据是否已送达。未经明确同意，不会写入任何内容。
weekly-traffic-report	简短总结每周流量、来源和目标。
traffic-drop-check	找出流量下降的原因。

Claude Code：

claude plugin marketplace add key-arg/skills
claude plugin install statable@statable

首次调用 Statable 工具时，会打开浏览器进行登录。若要让 Agent 创建目标和漏斗，请在授权页面授予“创建和配置你的网站”权限。如果你已经通过 claude mcp add statable ... 添加了服务，请将其移除，以免工具重复显示。

Gemini CLI（通过 gemini-extension.json 使用 MCP 服务和技能）：

gemini extensions install https://github.com/key-arg/statable-mcp

其他 Agent（仅技能；按上述方式连接 MCP 服务）：

npx skills add key-arg/statable-mcp

然后询问：“我应该在此网站上跟踪什么？”或运行 /statable:statable。

Configuration

Setting	Env	Flag	Default
API key	STATABLE_API_KEY	--api-key	none
Remote endpoint	STATABLE_MCP_URL	--url	https://mcp.statable.com/mcp

Without a key the server still starts and advertises its tools (so registries and hosts can inspect it), but every call returns a short message explaining how to add one.

Run from source

git clone https://github.com/key-arg/statable-mcp.git
cd statable-mcp
npm install
STATABLE_API_KEY=stbl_your_key npm test

Docker:

docker build -t statable-mcp .
docker run -i --rm -e STATABLE_API_KEY=stbl_your_key statable-mcp

About Statable

Statable is cookieless web analytics built for the EU: no consent banner needed for the core tracker, data hosted in the Netherlands, a tracker between 0.5 and 2 KB, goals, funnels, custom events, a public Stats API and this MCP server. Free tier for personal, educational and open-source sites.

Support: [email protected] · Registry: com.statable/analytics in the official MCP registry

MIT © Key Arg B.V.