Gemini Data Analysis & Research MCP Server

Gemini Data Analysis & Research MCP Server

Google の Gemini Flash 2 AI モデルを活用し、包括的なデータ分析、研究論文の生成、メールの自動配信を実現する強力な Model Context Protocol（MCP）サーバーです。データセットの分析、研究コンテンツの生成、結果の関係者へのメールによる直接配信を統合したソリューションを提供します。

🚀 特長

1. 高度なデータ分析とレポート作成（analyze-data）

• Excel（.xlsx、.xls）ファイルおよび CSV ファイルの包括的な分析
• 特長：
  • データ型の自動検出と解析
  • 数値列の統計分析
  • Chart.js を使用したインタラクティブな可視化
  • Gemini Flash 2 を使用した AI による分析情報
  • インタラクティブなプロットを含む詳細な HTML レポート
  • 分析結果のメールによる直接配信
  • 基本分析モードと詳細分析モード
  • 出力ディレクトリのカスタマイズ
  • 大規模データセットへの対応
  • 外れ値の自動検出
  • 数値列の相関分析

2. 研究とメール配信システム（send-email）

• 専門的な研究論文の生成と配信
• 特長：
  • AI による研究論文の生成
  • 分析結果のメールによる自動配信
  • 複数のコンテンツタイプに対応：
    • 研究論文
    • 技術レポート
    • データ分析の概要
    • ビジネスインテリジェンスレポート
  • プロフェッショナルなメール件名の生成
  • HTML とプレーンテキストの両方に対応
  • インライン表示に対応した画像の添付
  • 安全な SMTP 認証
  • 包括的なエラー処理とステータス報告
  • プロフェッショナルなメール形式
  • メッセージ配信の追跡
  • カスタマイズ可能なメールテンプレート

3. 研究・分析ジェネレーター（generate-thinking）

• 高度な研究・分析コンテンツの生成
• 特長：
  • 研究論文の生成
  • 技術文書の作成
  • データ分析の概要
  • ビジネスインテリジェンスレポート
  • タイムスタンプ付きの応答保存
  • 出力ディレクトリのカスタマイズ
  • 生成したコンテンツのメールによる直接配信
  • プロフェッショナルなコンテンツ作成

📊 クイックスタート

前提条件

• Node.js（v16 以降）
• TypeScript
• Claude Desktop
• Google Gemini API キー
• SMTP メールアカウント（メール機能を使用する場合）

インストール

1. クローンしてセットアップします：

git clone [your-repo-url]
cd gemini-data-analysis-email-generator
npm install

2. .env ファイルを作成します：

GEMINI_API_KEY=your_api_key_here
[email protected]
NODEMAILER_PASSWORD=your_app_password_here

3. プロジェクトをビルドします：

npm run build

Claude Desktop の設定

1. %AppData%/Claude/claude_desktop_config.json を作成または編集します：

{
  "mcpServers": {
    "Gemini Data Analysis": {
      "command": "node",
      "args": ["path/to/gemini-data-analysis-email-generator/dist/index.js"],
      "cwd": "path/to/gemini-data-analysis-email-generator",
      "env": {
        "GEMINI_API_KEY": "your_api_key_here",
        "NODEMAILER_EMAIL": "[email protected]",
        "NODEMAILER_PASSWORD": "your_app_password_here"
      }
    }
  }
}

2. Claude Desktop を再起動します

📊 ツールの使用方法

EDA と AI によるデータ分析

{
  "name": "analyze-data",
  "arguments": {
    "fileData": "base64_encoded_file_content",
    "fileName": "data.xlsx",
    "analysisType": "detailed",
    "outputDir": "./analysis_results"
  }
}

AI による件名生成を利用したメール送信

{
  "name": "send-email",
  "arguments": {
    "to": "[email protected]",
    "subjectPrompt": "Create a professional subject line for a business report",
    "text": "Hello! This is the plain text version of our email.",
    "html": "<h1>Hello!</h1><p>This is the <b>HTML</b> version of our email.</p>",
    "images": [
      {
        "name": "chart.png",
        "data": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA..."
      }
    ]
  }
}

思考の生成

{
  "name": "generate-thinking",
  "arguments": {
    "prompt": "Analyze the market trends for Q1 2024",
    "outputDir": "./thinking_output"
  }
}

📁 出力構成

output/
├── analysis/
│   ├── plots/
│   │   ├── column1_histogram_[timestamp].html
│   │   └── column2_histogram_[timestamp].html
│   ├── analysis_[timestamp].txt
│   └── report_[timestamp].html
├── thinking/
│   └── gemini_thinking_[timestamp].txt
└── emails/
    └── email_log_[timestamp].txt

🛠️ 開発

使用可能なスクリプト

• npm run build：TypeScript を JavaScript にコンパイルします
• npm run start：MCP サーバーを起動します
• npm run dev：ts-node を使用して開発モードで実行します

環境変数

• GEMINI_API_KEY：Google Gemini API キー
• NODEMAILER_EMAIL：メール送信用のメールアドレス
• NODEMAILER_PASSWORD：メールアプリのパスワード（Gmail の場合はアプリパスワードを使用します）

🔒 セキュリティに関する注意事項

• API キーは安全に保管してください
• .env ファイルを共有しないでください
• Gmail では、メインアカウントのパスワードではなくアプリパスワードを使用してください
• システムを通じて送信するメールの内容に注意してください
• メールの例に機密情報や個人情報を絶対に含めないでください

🐛 トラブルシューティング

よくある問題

1. API キーのエラー

   • .env ファイルが存在することを確認してください
   • API キーが有効か確認してください
   • 環境変数が適切に読み込まれていることを確認してください

2. Claude Desktop への接続

   • config.json の構文を確認してください
   • config 内のファイルパスを確認してください
   • Claude Desktop を再起動してください

3. メール送信の問題

   • NODEMAILER_EMAIL と NODEMAILER_PASSWORD が正しく設定されていることを確認してください
   • Gmail の場合は、アプリパスワードを作成していることを確認してください
   • Gmail 以外のプロバイダーの場合は、安全性の低いアプリからのアクセスが有効になっていることを確認してください
   • 宛先メールアドレスの形式を確認してください

4. データ分析の問題

   • ファイル形式がサポートされていることを確認してください（.xlsx、.xls、.csv）
   • ファイルのエンコーディングを確認してください（UTF-8 を推奨）
   • ファイルサイズが上限内であることを確認してください
   • 数値列が正しくフォーマットされていることを確認してください

デバッグモード

詳細なログを有効にするには、.env ファイルに DEBUG=true を追加してください：

GEMINI_API_KEY=your_key_here
DEBUG=true

📚 API リファレンス

データ分析ツール

interface AnalyzeDataParams {
  fileData: string;         // Base64 encoded file content
  fileName: string;         // File name (must be .xlsx, .xls, or .csv)
  analysisType: 'basic' | 'detailed';  // Analysis type
  outputDir?: string;      // Optional output directory
}

メール送信ツール

interface SendEmailParams {
  to: string;              // Recipient email address
  subjectPrompt: string;   // Prompt for Gemini to generate email subject
  text: string;            // Plain text version of email
  html?: string;           // HTML version of email (optional)
  images?: {               // Optional images to attach
    name: string;          // Image filename
    data: string;          // Base64 encoded image data
  }[];
}

思考生成ツール

interface GenerateThinkingParams {
  prompt: string;           // Analysis prompt
  outputDir?: string;       // Optional output directory
}

👨‍💻 作者

Falah G. Salieh
📍 イラク、バグダード
📅 2025

🤝 コントリビューション

1. リポジトリをフォークします
2. フィーチャーブランチを作成します
3. 変更をコミットします
4. ブランチにプッシュします
5. プルリクエストを作成します

📄 ライセンス

MIT License - 詳細は LICENSE ファイルを参照してください