这是一个基于 Model Context Protocol (MCP) 的服务器实现，用于连接 Microsoft Clarity 数据导出 API。它可以让您通过兼容 MCP 的大型语言模型 (LLM) 客户端（如 Claude for Desktop）轻松获取和分析 Clarity 网站流量数据。

主要功能点

• 通过简单的接口查询 Clarity 流量分析数据。
• 支持按浏览器、设备、国家/地区、操作系统等维度进行筛选。
• 可获取滚动深度、参与时间、流量等多种指标。
• 无缝集成兼容 MCP 的 LLM 客户端。

安装步骤

确保您的系统已安装 Node.js v16 或更高版本。

打开终端，运行以下命令通过 npm 全局安装：

npm install -g @microsoft/clarity-mcp-server

安装完成后，可以直接运行服务器：

clarity-mcp-server

您也可以在使用 npx 时通过 '--clarity_api_token' 参数直接提供 API 令牌：

npx @microsoft/clarity-mcp-server --clarity_api_token=您的令牌

服务器配置

MCP 服务器本身通常无需复杂配置，但您的 MCP 客户端需要知道如何启动并连接到此服务器。通常，您需要在客户端的配置中添加一个服务器条目，指定服务器的名称和启动命令。

例如，对于许多 MCP 客户端，配置可能类似于：

• 注册一个名为 '@microsoft/clarity-mcp-server' 的服务器。
• 指定启动命令为 'npx'，并传递参数 '@microsoft/clarity-mcp-server' 以及您的 Clarity API 令牌参数 '--clarity_api_token=您的令牌'（如果您选择通过命令行参数提供令牌）。

请查阅您的 MCP 客户端文档，了解具体的配置格式和位置。通常您需要在客户端的设置中找到与外部工具或 MCP 服务器相关的配置项。

基本使用方法

服务器运行后，在已配置并连接此服务器的 MCP 客户端（如 Claude for Desktop）中，您可以直接通过自然语言指示 LLM 调用服务器提供的工具。

例如，您可以对 LLM 说：

"请获取我最近一天的 Clarity 数据，按浏览器维度展示流量指标。"

客户端会识别您的意图，并提示您运行名为 'get-clarity-data' 的工具。您可能需要输入该工具所需的参数，例如：

• 天数 (numOfDays): 要查询的天数（1-3）。
• 维度 (dimensions): 要筛选的维度列表（可选，最多 3 个）。
• 指标 (metrics): 要获取的指标列表（可选）。
• 令牌 (token): 您的 Clarity API 令牌（如果未通过命令行参数或环境变量配置）。

LLM 客户端会根据您的指示和提供的参数调用服务器上的 'get-clarity-data' 工具，服务器将从 Microsoft Clarity API 获取数据并返回给客户端展示。