🚀 双子星 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;       // オプションの出力ディレクトリ
}

高度な使用法

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

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

// 可視化グラフを生成する
visualizeData('data.csv', './charts', 'custom', ['x', 'y'], ['scatter']);

📚 ドキュメント

注意事項

ファイルサイズ制限
単一ファイルの最大サポートサイズはシステムメモリに依存します。大規模なデータは分割して処理することを推奨します。
API 呼び出し制限
短時間に双子星 API を頻繁に呼び出さないでください。これによりレート制限がトリガーされる可能性があります。
データセキュリティ
CSV ファイルと API キーのセキュリティを確保し、不正アクセスを防いでください。

よくある質問

双子星 API キーをどのように取得できますか？
双子星の公式ウェブサイトにアクセスし、登録して開発者キーを取得してください。
可視化グラフが生成されない場合はどうすればいいですか？
Plotly アカウントが有効であることを確認し、ネットワーク接続が正常であることを確認してください。
分析結果が不正確な原因は何ですか？
データの前処理が不十分またはモデルパラメータの設定が不適切な可能性があります。具体的な状況に応じて調整してください。