teamyavio/yavio

Аналитика продуктов для приложений MCP и ChatGPT

Открытый исходный код. Самостоятельно. Посмотрите, как пользователи используют ваши инструменты ИИ.

Альфа (v0.1)** — Явио находится в стадии активного развития. API, конфигурация и схемы баз данных могут изменяться между выпусками без уведомления или путей миграции. Не используйте в производстве без привязки точных версий.

##Что такое Явио?

Yavio - это уровень аналитики и видимости для серверов MCP и приложений ChatGPT. Он фиксирует, как платформы ИИ (ChatGPT, Claude, Cursor, Windsurf, VS Code и т. Д.) вызывают ваши инструменты и как пользователи взаимодействуют с вашими виджетами - вызовами инструментов, конверсиями, воронками, ошибками, удержанием - с 3-линейной интеграцией SDK и полной аналитической панелью.

Вся платформа ** с открытым исходным кодом (MIT)** и самостоятельно размещена через Docker Compose. Облачный хостинг скоро появится.

Быстрый старт (Self-Hosted)

###1 Запуск платформы

При этом он будет находиться на уровне [[Т1]].

###2 Создать проект

Откройте панель инструментов, зарегистрируйте учетную запись, создайте рабочее пространство и проект, а затем скопируйте ключ API.

###3 Установите SDK

###4 Оберните MCP-сервер

Вот так.

Product Analytics for MCP Apps and ChatGPT Apps

Open-source. Self-hosted. See how users actually use your AI tools.

---

Alpha (v0.1) — Yavio is under active development. APIs, configuration, and database schemas may change between releases without notice or migration paths. Do not use in production without pinning exact versions.

What is Yavio?

Yavio is the analytics and visibility layer for MCP servers and ChatGPT Apps. It captures how AI platforms (ChatGPT, Claude, Cursor, Windsurf, VS Code, etc.) invoke your tools and how users interact with your widgets — tool calls, conversions, funnels, errors, retention — with a 3-line SDK integration and a full analytics dashboard.

The entire platform is open source (MIT) and self-hosted via Docker Compose. Cloud hosting is coming soon.

Quick Start (Self-Hosted)

1. Start the platform

git clone https://github.com/teamyavio/yavio.git
cd yavio

# Generate .env with random secrets
./scripts/setup-env.sh

# Start all services (migrations run automatically on first start)
docker compose up -d

The dashboard is at http://localhost:3000, ingestion API at http://localhost:3001.

2. Create a project

Open the dashboard, register an account, create a workspace and project, then copy your API key.

3. Install the SDK

npm install @yavio/sdk

4. Wrap your MCP server

import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { withYavio } from "@yavio/sdk";

const server = withYavio(
  new McpServer({ name: "my-app", version: "1.0.0" }),
  {
    apiKey: "yav_your_key_here",
    endpoint: "http://localhost:3001/v1/events",
  }
);

That’s it. Every tool call is now tracked automatically.

Using the CLI

You can also use the CLI for setup and platform management:

npm i -g @yavio/cli

# Interactive SDK setup — creates .yaviorc.json
yavio init

# Platform management
yavio up          # Start services
yavio down        # Stop services (data preserved)
yavio status      # Health check and stats
yavio logs        # Tail service logs
yavio doctor      # Diagnose setup issues

Features

• Zero-config MCP instrumentation — withYavio() wraps your MCP server and captures every tool call, latency, errors, and platform automatically