Umami Analytics MCP Server - MCP服务，MCP服务器，MCP教程

基本能力

产品定位

Umami Analytics MCP Server 是一个连接 Claude 和 Umami 分析平台的桥梁，提供网站数据分析能力。

核心功能

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

适用场景

• 网站性能优化
• 用户行为分析
• 实时访客监控
• 数据驱动的决策支持

工具列表

1. get_websites: 获取 Umami 账户中的网站列表及其 ID
2. get_website_stats: 获取关键指标（如页面浏览量、访客数、跳出率）
3. get_website_metrics: 分析特定指标（如 URL、引荐来源、浏览器、国家）
4. get_pageview_series: 获取可自定义时间间隔的页面浏览时间序列数据
5. get_active_visitors: 监控网站上当前活跃访客数量
6. get_session_ids: 检索特定事件或时间段的会话 ID
7. get_tracking_data: 获取特定会话 ID 的详细活动数据
8. get_docs: 对多个用户旅程进行语义搜索，返回最相关的片段
9. get_screenshot: 捕获网页的视觉快照
10. get_html: 检索和分析网页 HTML 源代码

常见问题解答

• 服务器初始化可能需要几分钟时间
• 建议启用 Claude Desktop 中的"Analysis tool"功能以获得最佳体验
• 屏幕截图会被降采样以避免上下文窗口问题

使用教程

使用依赖

• 安装 uv: pip install uv

安装教程

1. 配置 Claude Desktop 配置文件（MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json，Windows: %APPDATA%/Claude/claude_desktop_config.json）
2. 添加以下配置：
   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"
}
}
}
}
3. 替换路径和 Umami 凭证信息

调试方式

1. 打开 Claude Desktop，服务器将自动连接
2. 等待服务器初始化完成（可能需要几分钟）
3. 检查右下角的工具图标，确认10个工具可用
4. 使用"Create Dashboard Prompt"开始分析
5. 通过自然语言与 Claude 交互，请求特定数据分析

高级使用

1. 创建自定义提示：
2. 在 src/analytics_service/server.py 中定义提示结构
3. 实现提示处理逻辑
4. 遵循最佳实践创建有效的提示
5. 使用不同角色和内容类型构建结构化对话流
6. 利用资源类型处理复杂数据