microsoft/clarity-mcp-server

开发工具官方

本页由 AI 翻译，技术细节请以原文为准。查看原文

135 stars 37 forks 质量 72 趋势 17MIT

Repository Install

microsoft/clarity-mcp-server 是从 https://github.com/microsoft/clarity-mcp-server. 导入的 MCP 服务器候选

概览

microsoft/clarity-mcp-server 是从 https://github.com/microsoft/clarity-mcp-server. 导入的 MCP 服务器候选

概述（AI 翻译）

这是一台适用于 Microsoft Clarity 的模型上下文协议（MCP）服务器。它允许你通过Claude for Desktop或其他兼容MCP的客户端访问Clarity的会话录制、项目分析和文档。

主要特色

分析数据访问：查询您的Microsoft Clarity分析数据，包括流量指标、用户行为洞察和性能统计
会话录制检索：访问和分析会话录制，以理解用户交互并识别优化机会
自然语言查询：用通俗易懂的英语提问，从数据中获得洞见——无需学习复杂的查询语法或API端点
灵活数据过滤：按浏览器、设备、国家等多种维度过滤结果
实时数据访问：按需获取Clarity项目的最新分析数据和洞察
文档集成：直接在您的工作流程中，通过Microsoft Clarity文档获得快速解答和指导

本页由 AI 翻译，技术细节请以原文为准。

README

以下为原文 README 节选，完整内容请查看原文。

Microsoft Clarity MCP Server

This is a Model Context Protocol (MCP) server for the Microsoft Clarity. It allows you to access your session recordings, project analytics, and documentation from Clarity using Claude for Desktop or other MCP-compatible clients.

Key Features

Analytics Data Access: Query your Microsoft Clarity analytics data including traffic metrics, user behavior insights, and performance statistics
Session Recording Retrieval: Access and analyze session recordings to understand user interactions and identify optimization opportunities
Natural Language Querying: Ask questions in plain English to get insights from your data - no need to learn complex query syntax or API endpoints
Flexible Data Filtering: Filter results by various dimensions such as browser, device, country, and many more
Real-Time Data Access: Fetch the latest analytics data and insights from your Clarity projects on-demand
Documentation Integration: Get quick answers and guidance from Microsoft Clarity documentation directly within your workflow
Seamless MCP Integration: Works natively with Claude for Desktop, Visual Studio Code, and other Model Context Protocol (MCP) compatible clients

Setup and Installation

Prerequisites

Node.js v16 or higher
A Microsoft Clarity account and API token
Any MCP-compatible client (Claude for Desktop, etc.)

Installation

Option 1: Install via npm (recommended)

You can install and run this package directly using npm:

# Install globally
npm install -g @microsoft/clarity-mcp-server

# Run the server
clarity-mcp-server

Option 2: Run with npx without installing

You can run the server directly using npx without installing:

npx @microsoft/clarity-mcp-server

With either option, you can provide your Clarity API token using the --clarity_api_token parameter:

npx @microsoft/clarity-mcp-server --clarity_api_token=your-token-here

Option 3: Manual Installation

Clone or download this repository
Install dependencies:
```
npm install
```
Build the TypeScript code:
```
npm run build
```
Run the server:
```
npm run start
```

Extension/Plugin Installation

Visual Studio Code Extension

Click the button above to install the Microsoft Clarity MCP server directly in Visual Studio Code.

Claude Desktop Plugin

Install from Claude’s extension gallery:

Open Claude Desktop
Navigate to File → Settings → Extensions
Search for Microsoft Clarity
Click Install to add the extension

在 GitHub 查看完整 README

安装

npx @microsoft/clarity-mcp-server --clarity_api_token=your-api-token-here

新手？先看 mcpskill.org 教程 →

配置

{
  "mcpServers": {
    "@microsoft/clarity-mcp-server": {
      "command": "npx",
      "args": [
        "@microsoft/clarity-mcp-server",
        "--clarity_api_token=your-api-token-here"
      ]
    }
  }
}