MCP CSV 分析工具

🚀 雙子星 CSV 分析服務器文檔

雙子星 CSV 分析服務器是一款基於雙子星 AI 技術的高效數據分析工具，它能夠對 CSV 文件進行多種深度分析，為用戶挖掘數據價值提供有力支持。本文檔將詳細介紹該服務器的功能、安裝配置方法以及使用指南。

🚀 快速開始

雙子星 CSV 分析服務器支持對 CSV 文件進行深度分析。使用前，需完成安裝與配置，具體步驟可參考下文“📦 安裝指南”。安裝完成後，即可通過相關接口進行數據分析、可視化等操作。

✨ 主要特性

核心功能

CSV 數據解析：支持快速解析和處理標準 CSV 格式文件。
統計分析
- 基礎統計：提供均值、中位數、標準差等基本統計指標。
- 高級統計：支持分佈分析、偏度、峰態等深度統計。
數據質量評估：自動檢測並報告數據中的缺失值、重複值和異常值。
可視化生成：支持自動生成和輸出多種圖表類型，如柱狀圖、折線圖、散點圖等。
業務洞察：基於雙子星 AI 的深度學習能力，自動識別數據中的潛在關聯和趨勢。

分析模式

基礎分析：提供基本統計信息、數據質量報告和初步的可視化圖表。
詳細分析：包含高級統計指標、異常檢測、特徵重要性分析等深度內容。

📦 安裝指南

環境要求

操作系統：支持 Linux、Windows 和 macOS。
內存：建議 4GB 及以上，以應對大規模數據處理。
網絡：需要訪問雙子星 API 和 Plotly 服務。

安裝步驟

克隆代碼倉庫：

git clone https://github.com/your-repository.git
cd mcp-csv-server

安裝依賴項：

npm install

配置環境變量：
- 創建 .env 文件，添加以下內容：

GEMINI_API_KEY=你的雙子星API密鑰
PLOTLY_USERNAME=你的Plotly用戶名
PLOTLY_API_KEY=你的Plotly API密鑰

啟動服務器：

npm run start

💻 使用示例

數據分析工具接口

參數定義

interface AnalyzeCSVParams {
  csvPath: string;          // CSV 文件路徑
  outputDir?: string;       // 可選輸出目錄
  analysisType?: 'basic' | 'detailed';  // 分析類型
}

使用示例

# 基礎分析
analyzeCSV(csvFile.csv, 'basic');

# 詳細分析
analyzeCSV(csvFile.csv, 'detailed', './output');

數據可視化工具接口

參數定義

interface VisualizeDataParams {
  csvPath: string;          // CSV 文件路徑
  outputDir?: string;       // 可選輸出目錄
  visualizationType?: 'basic' | 'advanced' | 'custom';  // 可視化類型
  columns?: string[];       // 需要可視化的列
  chartTypes?: ('scatter' | 'line' | 'bar' | 'histogram' | 'box' | 'heatmap')[];  // 圖表類型
  customConfig?: Record<string, any>;  // 自定義配置
}

使用示例

# 基礎可視化
visualizeData(csvFile.csv);

# 高級可視化
visualizeData(csvFile.csv, './graphs', 'advanced', ['column1', 'column2'], ['scatter', 'line']);

智能分析工具接口

參數定義

interface GenerateThinkingParams {
  prompt: string;           // 分析提示語
  outputDir?: string;       // 可選輸出目錄
}

📚 詳細文檔

注意事項

⚠️ 重要提示

單個文件最大支持取決於系統內存，建議分批處理大規模數據。

避免短時間內頻繁調用雙子星 API，以免觸發速率限制。

確保 CSV 文件和 API 密鑰的安全性，避免未授權訪問。

常見問題

如何獲取雙子星 API 密鑰？ 請訪問雙子星官網註冊並獲取開發者密鑰。
可視化圖表無法生成怎麼辦？ 檢查 Plotly 賬號是否有效，並確保網絡連接正常。
分析結果不準確的原因是什麼？ 可能是數據預處理不足或模型參數設置不當，請根據具體情況進行調整。

附錄

命令行工具

啟動服務器：npm run start
執行測試：npm test

示例代碼

const { analyzeCSV, visualizeData } = require('./index');

// 進行基礎分析
analyzeCSV('data.csv', 'basic').then(console.log);

// 生成可視化圖表
visualizeData('data.csv', './charts', 'custom', ['x', 'y'], ['scatter']);