teamyavio/yavio

MCP 앱 및 ChatGPT 앱에 대한 제품 분석

공지사항 셀프 호스팅. 사용자가 AI 도구를 사용하는 방법을 알아보십시오.

---

Alpha (v0.1) - Yavio는 활성 개발 중입니다. API, 구성 및 데이터베이스 스키마는 공지 또는 마이그레이션 경로없이 릴리스 사이에 변경할 수 있습니다. 정확한 버전을 pinning 없이 생산에서 사용하지 마십시오.

Yavio는 무엇입니까?

Yavio는 MCP 서버와 ChatGPT 앱의 분석 및 가시 레이어입니다. 그것은 AI 플랫폼 (ChatGPT, Claude, Cursor, Windsurf, VS Code 등)이 도구와 사용자가 위젯과 어떻게 상호 작용하는지 캡처 - 도구 통화, 변환, 깔때기, 오류, 유지 - 3 라인 SDK 통합 및 전체 분석 대시보드.

전체 플랫폼은 ** 오픈 소스 (MIT) ** 및 Docker Compose를 통해 자체 호스팅. Cloud 호스팅이 곧 출시됩니다.

빠른 시작 (Self-Hosted)

##1. 플랫폼 시작

대쉬보드는 http://localhost:3000, ingestion API http://localhost:3001에 있습니다.

##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