Zaturn (SQL Data Analysis)

🚀 Zaturn - 強大的數據分析工具

Zaturn是一款專為數據分析師和商業用戶打造的工具，它提供了強大的數據分析功能，能連接多種數據源，還能直觀地展示數據，幫助用戶更好地理解和處理數據。

🚀 快速開始

Zaturn的安裝和配置都較為簡便，以下是具體步驟：

安裝步驟

1. 首先安裝uv工具：

   npm install -g uv
   

2. 使用uv命令安裝Zaturn：

   uv add zaturn
   

配置數據源

• 方式一：編輯配置文件，將數據源信息添加到sources.txt。

  • Linux/MacOS路徑：~/.config/zaturn/sources.txt
  • Windows路徑：%APPDATA%\zaturn\sources.txt

• 方式二：在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.

✨ 主要特性

• 支持多數據源：Zaturn能夠連接並分析多種類型的數據源，包括PostgreSQL、SQLite、DuckDB、MySQL、ClickHouse數據庫，以及CSV和Parquet文件。
• 直觀的數據可視化：生成豐富的圖表如散點圖、折線圖、柱狀圖等，幫助用戶更直觀地理解數據。如果MCP客戶端不支持圖片渲染，可使用--noimg參數以文件形式返回結果。
• 簡便的安裝配置：通過簡單的命令即可完成工具安裝，並提供靈活的配置方式，用戶可以選擇將數據源信息寫入sources.txt文件或直接在MCP配置中添加。

💻 使用示例

基礎用法

以下是一個示例用例，展示瞭如何使用Zaturn進行數據分析： 用戶提問：

列出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 功能，例如：

  基於過去三個月的收入，預測下個月的收入情況。
  

• 生成報告與演示文稿：用戶可以要求生成用於展示的PPT或PDF文件，使數據分析結果更易於分享和彙報。

獲取幫助

如需幫助或反饋，請訪問GitHub提交問題或加入Discord社區：

• GitHub
• Discord

支持項目

如果您發現Zaturn對您有所幫助，可以通過以下方式支持該項目：

• 在GitHub上為項目加星
• 分享給更多人
• 通過Patreon每月贊助9美元：支持鏈接

您的支持將幫助我投入更多時間改進Zaturn，使其更加完善。

數據集引用

項目中包含了Sarah Taha和PokéAPI整理的寶可夢數據集（Kaggle ID：sarahtaha/1025-pokemon），該數據集遵循CC BY-NC-SA 4.0協議，僅用於演示目的。

星數歷史