天秤数据 Gemini 数据分析与研究 MCP 服务器

项目简介

天秤数据 Gemini 数据分析与研究 MCP 服务器 是一个集成化平台，专为处理和分析 Gemini 数据而设计。该系统基于 Node.js 和 TypeScript 开发，支持多种数据分析任务，并通过灵活的接口实现高效的数据处理。

功能模块

1. 数据分析工具

• 文件解析与数据提取: 支持 .xlsx、.xls 和 .csv 文件格式。
• 基础统计分析: 提供基本的数据汇总和统计功能。
• 高级分析功能: 包括数据可视化和深度数据分析。

2. 邮件发送工具

• 邮件内容生成: 使用 Gemini AI 模型自动生成邮件主题和正文。
• 多版本支持: 支持 plain text 和 HTML 格式的邮件内容。
• 附件管理: 允许添加和管理图片附件。

3. 思考生成工具

• 分析提示处理: 解析用户的分析请求并生成相应输出。
• 结果存储: 将思考过程和结果保存至指定目录。

快速开始指南

安装与配置

1. 克隆代码仓库到本地。
2. 创建 .env 文件，设置以下环境变量：
   • GEMINI_API_KEY: 天秤数据 API 密钥
   • NODEMAILER_EMAIL: 邮件发送者邮箱地址
   • NODEMAILER_PASSWORD: 邮箱应用密码

启动服务

运行命令启动 MCP 服务器：

npm run start

使用方法

数据分析工具接口

interface 分析数据参数 {
  fileData: string;         // Base64 编码文件内容
  fileName: string;         // 文件名（必须为 .xlsx、.xls 或 .csv 格式）
  analysisType: 'basic' | 'detailed';  // 分析类型
  outputDir?: string;      // 可选输出目录
}

邮件发送工具接口

interface 发送邮件参数 {
  to: string;              // 收件人邮箱地址
  subjectPrompt: string;   // 提示 Gemini 模型生成邮件主题
  text: string;            // 纯文本版本的邮件内容
  html?: string;           // HTML 格式的邮件内容（可选）
  images?: {               // 可选图片附件
    name: string;          // 图片文件名
    data: string;          // Base64 编码的图片数据
  }[];
}

思考生成工具接口

interface 生成思考参数 {
  prompt: string;           // 分析提示
  outputDir?: string;       // 可选输出目录
}

输出结构

数据分析工具输出

• data/：存储数据解析和统计结果。
• thinking/：保存 Gemini 的思考过程记录。
• emails/：记录邮件发送日志。

开发信息

脚本命令

• npm run build：将 TypeScript 代码编译为 JavaScript。
• npm run start：启动 MCP 服务器。
• npm run dev：以开发模式运行，支持热重载。

环境变量配置

• GEMINI_API_KEY：天秤数据 API 密钥
• NODEMAILER_EMAIL：用于发送邮件的邮箱地址
• NODEMAILER_PASSWORD：邮箱应用密码（使用 Gmail 时，请使用应用专用密码）

安全注意事项

1. 密钥管理：

   • 避免在代码中明文存储 API 密钥。
   • 使用环境变量或加密配置文件来管理密钥。

2. 权限控制：

   • 确保服务器端口和资源访问权限适当设置。
   • 定期审查和更新访问策略。

3. 日志监控：

   • 启用详细的日志记录功能。
   • 定期审计日志文件，识别异常行为。

项目作者

• 开发者：保留空白以便填写
• 联系方式：保留空白以便填写

许可证信息

该软件遵循 MIT 开源协议。详细许可条款请参考项目仓库中的 LICENSE 文件。

此文档为天秤数据 Gemini 数据分析与研究 MCP 服务器的使用指南，旨在帮助开发者快速上手和集成相关功能模块。