Umami Analytics MCP Server

MCP搜索检索

提供方 jakeyShakey

搜索检索 HTTP · 远程 无需鉴权 社区 / 第三方 Claude DesktopClaudeCursor
查看接入方式

Umami Analytics MCP Server是一个增强Claude能力的模型上下文协议服务器,通过提供来自Umami的网站分析数据,使Claude能够分析用户行为、跟踪网站性能并提供数据驱动的见解。

一句话选型结论

按资料字段整理

Umami Analytics MCP Server 属于搜索检索类 MCP 服务器,HTTP · 远程,无需鉴权,可直接接入 Claude Desktop、Claude、Cursor,有可直接复制的远程端点配置。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类搜索检索 传输方式HTTP · 远程 鉴权无需鉴权 部署方式支持远程部署
GitHub 星标 7 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

搜索检索
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

网站分析Python本地部署用户行为分析数据可视化性能监控语义搜索

安装与配置

HTTP · 远程 无需鉴权
连远程 HTTPS 端点,通常为 Streamable HTTP
pip install umami

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    确认你的客户端支持远程端点,并拿到服务地址。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
联网搜索取证

让模型查最新资料并给出出处。

资料聚合

把一个主题的网页、文档集中抓回来整理。

情报与竞品检索

按关键词持续检索行业动态和竞品信息。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude Desktop、Claude、Cursor,换客户端不用重新研究配置。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • 远程端点依赖网络与服务方可用性,注意密钥与调用额度。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在搜索检索场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Umami Analytics MCP Server当前 未标注 HTTP · 远程 支持远程部署 有 2026-05-17
Brave Search 433812ff 2 未标注 未标注 无 2026-05-17
Sequentialthinking 1 SSE · 服务端推送 远程部署 有 2026-05-18
Baidu Netdisk 未标注 未标注 未标注 无 2026-05-17
ragflow 未标注 stdio · 本地进程 本地部署 有 2026-04-11
mindsdb (430e18) 未标注 未标注 未标注 有 2026-05-17

服务器档案

搜索检索
字段来自项目仓库与公开索引,中文说明由本站标注
提供方jakeyShakey上游标注的维护方 jakeyShakey
分类搜索检索本站按上游分类展示
连接方式HTTP · 远程连远程 HTTPS 端点,通常为 Streamable HTTP
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · Python本地安装时用到的包标识与运行时
部署类型支持远程部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

9.3 KB
来自项目仓库与上游目录的原文,未做删改

Umami分析MCP服务器

一种模型上下文协议(MCP)服务器,通过提供对Umami网站分析数据的访问来增强Claude的能力。该服务器允许Claude分析用户行为,跟踪网站性能,并提供数据驱动的见解。

代码库是使用Claude Sonnet 3.5和Cursor从头到尾生成的。

它做什么

此服务器将Claude连接到您的Umami分析平台,使其能够:

  • 分析用户旅程和行为模式
  • 跟踪网站性能指标
  • 实时监控访客活动
  • 捕获和分析网页内容
  • 从历史分析数据中生成见解

运作原理

服务器为Claude提供以下工具来分析网站数据:

可用工具

  • get_网站:检索您的Umami帐户中的网站及其ID列表
  • get_website_stats:获取网站的页面浏览量、访问者、跳出率等关键指标
  • get_website_metrics:分析特定指标,如网址、推荐人、浏览器、国家
  • get_pageview_series:获取具有可自定义间隔的时间序列页面浏览量数据
  • get_active_visiors:监控网站上当前活跃访问者的数量
  • get_session_ids:检索特定事件或时间段的会话ID
  • 获取跟踪数据:获取特定会话ID的详细活动数据
  • get_docs:在许多用户旅程中执行语义搜索,返回给定问题的最相关块
  • get_creenshot:捕获网页的视觉快照
  • get_html:检索和分析网页HTML源代码

每个工具都有一个描述和一个可以传递给它的参数列表。这些用于提供上下文和信息,使Claude能够有效地为作业选择合适的工具,并提供正确的参数。

这些工具大多直接从Umami API将数据拉入Claude Desktop,但get_docs添加了语义搜索步骤,以避免Claude出现上下文窗口问题,并节省令牌使用。使用Umami API检索给定事件的所有用户旅程,然后将这些旅程分为较小的部分,并使用拥抱面部的开放式soruce句子转换模型嵌入。然后,根据问题,检索最相关的块并将其返回给Claude,从而可以分析用户在网站上执行的具体操作和行为,这是传统数据可视化工具难以复制的。这种嵌入和语义搜索的实现在 src/analytics_service/embeddings.py 文件。

此外,get_creenshot和get_html工具使用开源 Crawl4AI 网络爬虫,用于检索给定网站的HTML源代码和屏幕截图。必须对截图进行降采样以减小其大小,以避免克劳德的上下文窗口问题。这使您能够向Claude提供有关网站结构和外观的上下文,从而为提高网站性能提供更准确和相关的建议。网络爬虫的实现在 src/analytics_service/crawler.py 文件。

安装指南

先决条件

  • 安装uv: pip install uv
  1. Claude桌面配置

将以下内容添加到您的Claude Desktop配置文件中:

  • MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • 窗户: `%APPDATA%/Claude/claude_desktop_config.json````json
    {
    "mcpServers": {
    "analytics_service": {
    "command": "uv",
    "args": [
    "--directory",
    "/path/to/analytics_service",
    "run",
    "analytics-service"
    ],
    "env": {
    "UMAMI_API_URL": "https://example.com",
    "UMAMI_USERNAME": "yourUmamiUsername",
    "UMAMI_PASSWORD": "yourUmamiPassword",
    "UMAMI_TEAM_ID": "yourUmamiTeamId"
    }
    }
    }
    }

替换 `/path/to/analytics_service` 带有analytics_service目录的实际路径。

对于UMAMI_API_URL,更换 `https://example.com` 使用您正在使用的Umami版本的URL(自托管或托管在Umami Cloud上)。
对于UMAMI_USENAME和UMAMI_PASSWORD,替换 `yourUmamiUsername` 和 `yourUmamiPassword` 使用您的Umami帐户凭据。
对于UMAMI_TEAM_ID,替换 `yourUmamiTeamId` 使用您要分析的团队的ID。

1. **打开克劳德桌面**

当您打开Claude Desktop时,它将自动开始连接到analytics_service MCP服务器。在服务器初始化和安装正确的软件包时,最多需要几分钟的时间。当服务器准备就绪时,您将在聊天窗口的右下角看到10个可用的MCP工具。这用一个小锤子图标和旁边的数字10表示。

此外,如果您还没有,强烈建议您在Claude Desktop的功能预览中启用“分析工具”。这将允许Claude为您构建仪表板以及其他数据可视化。为此,在左侧面板中,找到“功能预览”选项卡,并在其中启用“分析工具”。LaTeX渲染也可以在同一部分中启用。

## 如何使用服务器

### 入门指南

最简单的开始方法是使用 **创建仪表板提示** 由服务器提供。通过单击聊天窗口左下角的“从MCP附加”附件按钮来选择。然后选择选择实现,然后选择创建仪表板提示。

这将指导您完成为您的网站创建仪表板的过程,要求:

1. 您要分析的网站的名称
1. 分析的开始和结束日期
1. 网站的时区

提供此信息后,服务器将生成一个txt文件,指示Claude如何构建仪表板。
在聊天窗口中按enter键,Claude将完成其余操作。然后,您可以要求Claude对仪表板进行任何更改或添加任何其他可视化。

### 自然语言用法

为了获得更可定制的体验,您可以直接与Claude交谈,并指定自己的要求,例如您想在仪表板上看到什么数据以及您想使用什么可视化。此外,您可以分析用户旅程,以确定具体的痛点,并从您的网站添加截图,为Claude提供额外的上下文

克劳德将自动使用完成您请求所需的工具。只需用自然语言提出请求,Claude将决定使用哪些工具。如果你想查看所有可用工具的列表,你可以让克劳德为你列出它们,或者点击聊天窗口右下角的锤子图标。

### 创建自己的提示

您还可以为经常使用的工作流创建自己的提示。为此,您需要:

1. **定义您的提示结构**
创建一个提示定义,其中包括:

- `name`:提示的唯一标识符
- `description`:明确解释提示的作用
- `arguments`:提示所需的输入参数列表

将此添加到 `list_prompts()` 功能在 `src/analytics_service/server.py`:

示例结构:```python
@app.list_prompts()
async def list_prompts():
return [
# ... existing prompts ...
{
"name": "Your Prompt Name",
"description": "Your prompt description",
"arguments": [
{
"name": "Parameter Name 1",
"description": "Parameter description",
"required": True/False
},
{
"name": "Parameter Name 2",
"description": "Parameter description",
"required": True/False
}
]
}
]
  1. 实施提示
    在中添加您的提示处理逻辑 get_prompt() 功能在 src/analytics_service/server.py:```python
    @app.get_prompt()
    async def get_prompt(name: str, arguments: Any):

... existing prompts ...

if name == "Your Prompt Name":
return {
"messages": [
{
"role": "user",
"content": {
"type": "text",
"text": f"Your prompt template with {arguments['Parameter Name']}"
}
}
]
}


在提示中定义消息时 `role` 字段对于构建对话至关重要:

- 使用 `"role": "user"` 用于模拟用户输入或问题的消息
- 使用 `"role": "assistant"` 用于表示Claude的响应或指示的消息
- 使用 `"role": "system"` 用于设置上下文或提供高级指令的消息

这 `content` 每条消息中的字段必须指定 `type`。可用类型有:

- `"type": "text"` -对于纯文本内容
- `"type": "resource"` -用于包含文件、日志或其他数据等外部资源。必须包括 `resource` 对象具有:
- `uri`:资源标识符
- `text`:实际内容
- `mimeType`:内容的MIME类型(例如,“text/plain”、“text/x-python”)

虽然资源确实包含了它们的内容 `text` 字段,使用 `resource` type提供了几个重要的好处:

1. **内容类型意识**:The `mimeType` 字段告诉Claude如何解释内容(例如,作为Python代码、纯文本或其他格式)
1. **来源追踪**:The `uri` 字段维护了一个指向内容来源的引用,这对以下方面很有用:
- 追踪数据来源
- 如果源更改,则启用更新
- 提供有关资源位置和用途的上下文
1. **结构化数据处理**:资源格式允许对不同类型的内容进行一致的处理,同时维护每个资源的元数据

下面是一个显示不同角色和内容类型的示例:```python
"messages": [
{
"role": "system",
"content": {
"type": "text",
"text": "Analyze the following log file and code for potential issues."
}
},
{
"role": "user",
"content": {
"type": "resource",
"resource": {
"uri": "logs://recent",
"text": "[2024-03-14 15:32:11] ERROR: Connection timeout",
"mimeType": "text/plain"
}
}
},
{
"role": "assistant",
"content": {
"type": "text",
"text": "I notice a connection timeout error. Let me examine the related code."
}
},
{
"role": "user",
"content": {
"type": "resource",
"resource": {
"uri": "file:///code.py",
"text": "def example():\n    pass",
"mimeType": "text/x-python"
}
}
}
]

对于大多数提示,具有用户角色的文本类型绰绰有余,并允许Claude在响应中拥有更多的控制权和创造力。然而,对于更复杂的工作流程,具有不同角色和类型的多条消息允许更结构化的对话流和更多的用户对响应的控制。

  1. 创建提示的最佳实践
  • 使您的提示集中且具体
  • 包括对参数的明确验证要求
  • 为参数使用描述性名称
  • 在参数描述中包含示例值
  • 构建提示模板,有效指导Claude
  • 考虑错误处理和边缘情况
  • 用各种输入测试提示

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
Umami Analytics MCP Server 怎么安装?

在客户端按下面的安装命令接入:pip install umami。装完在客户端配置里引用同一个包或端点。

Umami Analytics MCP Server 怎么在 Claude Desktop、Claude、Cursor 里配置?

它的传输方式是HTTP · 远程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Umami Analytics MCP Server 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Umami Analytics MCP Server 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

Umami Analytics MCP Server 支持哪些客户端?

资料标注支持 Claude Desktop、Claude、Cursor;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Umami Analytics MCP Server 能提供哪些能力?

资料显示能力标签包括 数据可视化、Python、Claude、性能监控。具体工具清单以官方文档为准。

Umami Analytics MCP Server 需要什么运行环境?

运行时为 Python;属于远程端点,不需要在本地装运行时。

Umami Analytics MCP Server 是本地还是远程?

它是远程端点,连服务地址即可。传输方式为HTTP · 远程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。