Gemini Data Analysis Research MCP Server

🚀 GEMINI データ分析プラットフォーム

GEMINI データ分析プラットフォームは、強力なデータ分析機能や、AIを活用した研究支援、思考生成などの多彩な機能を提供し、データの分析や報告書作成、メール送信などの業務を効率化します。

🚀 クイックスタート

インストールと実行

1. リポジトリをクローンする

   git clone your_repository.git
   

2. 依存関係をインストールする

   npm install
   

3. サービスを起動する

   npm run start
   

✨ 主な機能

1. Gemini データ分析ツール

• 機能説明: 強力なデータ分析とレポート生成機能を提供し、複数のデータファイル形式をサポートします。
• サポートするファイル形式: .xlsx, .xls, .csv

2. 研究とメール送信システム

• メール送信機能: Gemini AI を利用したスマートなメール件名生成、テキスト内容の作成、HTML形式のメール作成をサポートします。
• 添付ファイル管理: メールに画像を追加および埋め込むことができます。

3. 思考生成ツール

• AI駆動の思考: Gemini モデルを使用して複雑な問題を分析し、深い思考過程のドキュメントを出力します。

💻 使用例

データ分析ツールのインターフェース定義

interface AnalyzeDataParams {
  fileData: string;         // Base64 エンコードされたファイル内容
  fileName: string;         // ファイル名（.xlsx, .xls または .csv である必要があります）
  analysisType: 'basic' | 'detailed';  // 分析タイプ
  outputDir?: string;      // オプションの出力ディレクトリ
}

メール送信ツールのインターフェース定義

interface SendEmailParams {
  to: string;              // 受信者のメールアドレス
  subjectPrompt: string;   // Gemini にメール件名を生成させるためのプロンプト文
  text: string;            // メールの純テキストバージョンの内容
  html?: string;           // オプションの HTML 形式のメール内容
  images?: {               // オプションの画像添付ファイル
    name: string;          // 画像ファイル名
    data: string;          // Base64 エンコードされた画像データ
  }[];
}

思考生成ツールのインターフェース定義

interface GenerateThinkingParams {
  prompt: string;           // 分析のプロンプト文
  outputDir?: string;       // オプションの出力ディレクトリ
}

📚 ドキュメント

出力構造

データ分析モジュールの出力例

• ファイル名: report_[日付時間].html
• 位置: ./output/reports/

思考生成モジュールの出力例

• ファイル名: gemini_thinking_[日付時間].txt
• 位置: ./output/thinking/

開発情報

利用可能なスクリプトコマンド

1. npm run build: TypeScript コードを JavaScript にコンパイルします。
2. npm run start: MCP サービスを起動します。
3. npm run dev: 開発モードで実行します（ts-node を使用）。

環境変数の設定

• GEMINI_API_KEY: あなたの Google Gemini API キー
• NODEMAILER_EMAIL: あなたのメールアドレス
• NODEMAILER_PASSWORD: あなたのメールアプリパスワード

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

1. APIキーの管理: APIキーを安全に保管し、漏洩を防いでください。
2. 環境ファイルの保護: 機密情報を含む .env ファイルを共有しないでください。
3. Gmailの設定: Googleアカウントを使用する場合は、メインパスワードではなくアプリパスワードを使用してください。

トラブルシューティング

一般的な問題

1. APIキーのエラー

   • .env ファイルが存在し、正しく設定されていることを確認してください。
   • キーの有効性を検証してください。
   • 環境変数が正常に読み込まれていることを確認してください。

2. Claude Desktop の接続問題

   • config.json ファイルの構文が正しいことを確認してください。
   • ファイルパスが正しいことを確認してください。
   • Claude Desktop アプリケーションを再起動してください。

3. メール送信失敗

   • メールアドレスの形式が正しいことを確認してください。
   • ネットワーク接続が正常であることを確認してください。
   • SMTP 設定パラメータが正しいことを確認してください。

連絡先

• 開発者のメールアドレス: your.email@example.com
• プロジェクトのリポジトリリンク: https://github.com/yourusername/yourrepository

⚠️ 重要提示

このプラットフォームを使用する前に、関連する法律、規制、サービス利用規約をよく読み、遵守してください。