mcpField
Y
yourtraffic

yourtraffic

本地服务
github.com/kozmos-tech数据与分析115 周前更新
代码仓库

关于 yourtraffic

yourtraffic 为网站运营者提供可自托管的流量分析，不使用 Cookie 或个人数据。它同时提供 REST API 和支持 OAuth 的 MCP 服务。

主要功能

  1. 01注重隐私的流量分析
  2. 02跟踪不限数量的网站
  3. 03用于统计数据的 REST API
  4. 04通过控制台配置网站

适用场景

  1. 01查看多个网站的流量
  2. 02通过 REST API 获取统计数据
  3. 03授权 Agent 访问分析数据

MCP 相关

在 `/mcp` 提供 MCP 服务，供 Agent 访问分析数据。通过 OAuth 批准访问，无需 API 密钥。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "kozmos-tech-yourtraffic": {
      "command": "npx",
      "args": [
        "-y",
        "@kozmos-tech/yourtraffic"
      ]
    }
  }
}
启动命令npx -y @kozmos-tech/yourtraffic

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npm@kozmos-tech/yourtraffic0.1.1

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

YourTraffic

开源、隐私优先的 Web 分析工具。网站数量不限，提供一流的 REST API 和面向 Agent 的原生 MCP 服务。无 Cookie、无个人数据、无同意横幅。

自托管

前提条件
  • 已全局安装 Vercel CLI
  • 一个 Postgres 数据库
  • Node 20 或更高版本
设置

克隆仓库并安装依赖项。

git clone https://github.com/kozmos-tech/yourtraffic
cd yourtraffic
npm install

复制示例环境变量文件并填写内容。

cp .env.example .env
  • DATABASE_URL。Postgres 连接字符串。没有它，应用将无法启动。
  • BETTER_AUTH_SECRET。一个足够长的随机密钥。使用 openssl rand -base64 32 生成。切勿使用默认值，因为访客哈希会以它作为盐值。
  • BETTER_AUTH_URL。部署的公开源地址，例如 https://analytics.example.com。开发时使用 http://localhost:3000。这也是 MCP 客户端用于发现 OAuth 的源地址，因此必须是准确的公开 URL，且末尾不能带路径。
  • GOOGLE_CLIENT_ID 和 GOOGLE_CLIENT_SECRET。可选。设置这两项即可在登录和注册页面启用 Google 登录。在 Google Cloud 控制台中创建 OAuth 凭据，并将 BETTER_AUTH_URL + /api/auth/callback/google 添加为授权重定向 URI。留空则隐藏 Google 按钮。

首次运行前，请创建数据库表。

npm run db:migrate
运行
vc dev
open http://localhost:3000

登录并添加网站，然后将显示的代码片段放入网站的 <head> 中。首次访问后，几秒内即可看到统计数据。

部署

npm install
vc deploy

在 Vercel 项目设置中配置 DATABASE_URL、BETTER_AUTH_SECRET 和 BETTER_AUTH_URL，然后针对生产数据库运行迁移。

数据库

架构位于 src/db/schema.ts。修改后生成迁移，然后应用迁移。

npm run db:generate
npm run db:migrate

查看统计数据

每个项目都有一个 API 密钥，可在控制面板的 Settings 下查看。

  • REST API。将密钥作为 Bearer 令牌传递给 /api/v1/stats。完整指南请参阅 llms.txt。
  • MCP 服务。让 Agent 连接到 /mcp。它使用 OAuth，因此你只需登录并批准访问，无需 API 密钥。

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。