KrystalView Analytics

io.github.McSlaine由 GitHub 账号 McSlaine 发布v0.1.2更新于 Oct 24, 2026

AI agent access to website analytics, session replay, and anomaly detection.

已验证STDIO仅桌面效率与工作流数据与分析

概览

AI 生成的概览

让助手查询 KrystalView 网站分析数据，包括访客会话、漏斗、营销活动、错误和异常提醒。

可以做什么
将 AI 助手连接到 KrystalView 网站分析。只读工具涵盖访客会话与会话详情、站点统计、滚动深度、实时访客、AI 检测的异常、转化漏斗与逐步流失分析、UTM 营销活动汇总、会话与 ROAS、聚合的浏览器错误以及通知。它既可以作为托管远程 MCP 端点运行，也可以作为本地 stdio 包直接代理到 KrystalView API。
适用场景
适合希望不打开 KrystalView 面板就能向助手询问站点表现、流量变化、漏斗流失、营销活动效果或用户体验障碍的场景。适用于已经在使用 KrystalView 做分析和会话回放的团队。
运行要求
需要 KrystalView 账户，以及在控制台 Settings > API Keys 生成的 API 密钥，通过 KRYSTALVIEW_API_KEY 提供。本地方式需要 Python 和 krystalview-mcp 包；托管方式需要支持远程 MCP 与 OAuth 的客户端。可选 KRYSTALVIEW_BASE_URL 和 KRYSTALVIEW_TIMEOUT。需要访问 KrystalView API 的网络连接。
安装前请注意
需要密钥 KRYSTALVIEW_API_KEY，该密钥仅限单个站点使用，可在控制台轮换或撤销。工具为只读，但会把访客会话、营销活动和错误数据暴露给助手及其提供方。托管端点也接受通过 Authorization 或 X-API-Key 请求头传入的只读 API 密钥。默认速率限制为每分钟 60 次请求。

安装

在 SourceWeft 中

  1. 打开 控制台中的 KrystalView Analytics，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

KrystalView MCP Server

Give your AI agents direct access to website analytics. Query visitor sessions, investigate UX friction, analyze conversion funnels, review campaigns and errors, and get anomaly alerts — all from Claude, Cursor, or any MCP-compatible client.

Connection Options

Hosted Remote MCP

Use this when your client supports remote MCP servers or connector-style OAuth. No local package install is required.

FieldValue
Endpointhttps://krystalview.com/mcp
Transportstreamable-http
AuthenticationOAuth authorization code + PKCE
OAuth metadatahttps://krystalview.com/.well-known/oauth-authorization-server
Protected resource metadatahttps://krystalview.com/.well-known/oauth-protected-resource

During OAuth, KrystalView asks the signed-in user to choose the site the MCP client can read. The issued token is read-only and scoped to that site. The hosted OAuth server supports dynamic client registration, authorization code + PKCE, resource indicators, refresh-token rotation, and token revocation.

For clients that support custom headers instead of OAuth, the hosted endpoint also accepts a KrystalView read API key as either:

http
Authorization: Bearer kv_live_...

or:

http
X-API-Key: kv_live_...

Local stdio MCP Package

Use this when your MCP client runs local stdio servers, such as Claude Desktop, Claude Code, Cursor, or similar developer tools.

Install

bash
pip install krystalview-mcp

Configure

Generate an API key in your KrystalView console under Settings > API Keys.

Claude Desktop

Add to your claude_desktop_config.json:

json
{  "mcpServers": {    "krystalview": {      "command": "krystalview-mcp",      "env": {        "KRYSTALVIEW_API_KEY": "your-api-key-here"      }    }  }}
Claude Code
bash
claude mcp add krystalview -- krystalview-mcp# Then set your API key:export KRYSTALVIEW_API_KEY="your-api-key-here"
Cursor

Add to your MCP settings:

json
{  "krystalview": {    "command": "krystalview-mcp",    "env": {      "KRYSTALVIEW_API_KEY": "your-api-key-here"    }  }}

Available Tools

ToolDescription
get_sessionsList/search visitor sessions with filters (device, location, friction, rage clicks)
get_session_detailDeep dive into a specific session — full timeline, events, navigation path
get_site_statsAggregate performance metrics — sessions, friction, devices, top pages
get_scroll_depthScroll-depth buckets for a specific page path
get_live_visitorsCurrently active visitor count and recent live sessions
get_anomaliesAI-detected anomalies with explanations (traffic spikes/drops, friction surges)
get_funnelsList defined conversion funnels
get_funnel_analysisStep-by-step funnel conversion rates and drop-off analysis
get_campaign_summaryUTM campaign attribution summary
get_campaign_sessionsVisitor sessions from a specific campaign
get_campaign_roasPaid campaign spend, conversions, and ROAS where connected
get_errorsAggregated client-side browser errors
get_notificationsRecent KrystalView notifications and insights

Example Prompts

Once connected, try asking your AI assistant:

  • "How's my site performing this week?"
  • "Show me frustrated mobile users from the last 24 hours"
  • "Why did our traffic drop yesterday?"
  • "Where are users dropping off in the checkout funnel?"
  • "Find sessions with rage clicks on the pricing page"
  • "Which campaigns are driving the most high-friction sessions?"
  • "Show me unresolved browser errors with sample session IDs"
  • "Are there any anomalies I should know about?"

Environment Variables

VariableRequiredDefaultDescription
KRYSTALVIEW_API_KEYYes—Your KrystalView API key
KRYSTALVIEW_BASE_URLNohttps://krystalview.com/apiAPI base URL
KRYSTALVIEW_TIMEOUTNo15Request timeout in seconds

Rate Limits

API keys have configurable rate limits (default: 60 requests per minute). Rate limit headers are included in every response. If you hit the limit, the server returns a clear error with retry timing.

Security

  • API keys are scoped to a single site — agents can only access data for the site the key was created for
  • OAuth tokens issued by the hosted MCP endpoint are read-only and scoped to the selected site
  • Hosted OAuth supports refresh-token rotation and token revocation
  • Browser-originating MCP/OAuth requests are checked against explicit trusted origins
  • Tools are read-only
  • All requests use HTTPS
  • Keys can be rotated or revoked in the KrystalView console
  • The local stdio package stores no data — it proxies directly to the KrystalView API

License

MIT

来源：README.md，提交 f4df256

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v0.1.2最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分