Zaturn (SQL Data Analysis)

🚀 Zaturn

Zaturnは、データアナリストやビジネスユーザー向けの強力なデータ分析ツールです。多様なデータソースに対応し、直感的なデータ可視化機能を備えており、簡単にインストールと設定ができます。

🚀 クイックスタート

Zaturnは、データ分析に特化したツールで、多様なデータソースからのデータを分析し、可視化することができます。以下に、基本的な使い方を紹介します。

✨ 主な機能

• 多様なデータソース対応：Zaturnは、PostgreSQL、SQLite、DuckDB、MySQL、ClickHouseなどのデータベースや、CSV、Parquetファイルなどの多様なデータソースに接続し、分析することができます。
• 直感的なデータ可視化：散点図、折れ線グラフ、棒グラフなどの豊富なグラフを生成し、データを直感的に理解することができます。MCPクライアントが画像レンダリングに対応していない場合は、--noimgパラメータを使用して、結果をファイル形式で返すことができます。
• 簡単なインストールと設定：簡単なコマンドでツールをインストールでき、柔軟な設定方法を提供しています。ユーザーは、データソース情報をsources.txtファイルに記述するか、MCP設定に直接追加することができます。

📦 インストール

インストール手順

1. まず、uvツールをインストールします。

   npm install -g uv
   

2. uvコマンドを使用して、Zaturnをインストールします。

   uv add zaturn
   

データソースの設定

• 方法1：設定ファイルを編集し、データソース情報をsources.txtに追加します。

  • Linux/MacOSのパス：~/.config/zaturn/sources.txt
  • Windowsのパス：%APPDATA%\zaturn\sources.txt

• 方法2：MCP設定で直接データソースを指定します。

  "args": [
    "--noimg",
    "mysql+pymysql://username:password@host/database"
  ]
  

システムプロンプトの設定

分析結果の正確性と信頼性を確保するために、以下のシステムプロンプトを設定することをお勧めします。

You are a helpful data analysis assistant. Use only the provided data sources to process user inputs. Do not use external knowledge bases.

💻 使用例

基本的な使用法

ユーザーの質問：

列出Northwind数据库中收入前五名的客户。

AIの回答：

The top 5 customers by revenue for Northwind are:

1. B's Beverages with a revenue of $6,154,115.34
2. Hungry Coyote Import Store** with a revenue of $5,698,023.67
3. Rancho grande with a revenue of $5,559,110.08
4. Gourmet Lanchonetes with a revenue of $5,552,597.90
5. Ana Trujillo Emparedados y helados with a revenue of $5,534,356.6

📚 ドキュメント

将来の計画

• データソースの拡張：より多くの種類のデータソースへの接続をサポートする予定です。
• 予測分析の強化：過去のデータに基づく予測やforecasting機能を実装します。例えば、過去3か月の収入を元に、翌月の収入状況を予測することができます。

基于过去三个月的收入，预测下个月的收入情况。

• レポートとプレゼンテーションの生成：ユーザーがPPTやPDF形式のレポートを生成できるようにし、データ分析結果を簡単に共有し、報告できるようにします。

ヘルプの取得

ヘルプが必要な場合やフィードバックを提供したい場合は、以下のリンクを利用してください。

• GitHub
• Discord

プロジェクトのサポート

Zaturnが役に立った場合は、以下の方法でプロジェクトをサポートすることができます。

• GitHubでプロジェクトにスターを付ける
• 他の人に共有する
• Patreonで月額9ドルの支援を行う：サポートリンク

あなたの支援により、Zaturnをさらに改善するための時間を割くことができます。

データセットの引用

このプロジェクトには、Sarah TahaとPokéAPIによって整理されたポケモンデータセット（Kaggle ID：sarahtaha/1025-pokemon）が含まれています。このデータセットは、CC BY-NC-SA 4.0ライセンスに基づいており、デモ目的でのみ使用されています。

スター数の履歴