Gdrive Hpc MCP

Google Drive 高性能计算（HPC）日志分析器

一个模型上下文协议（MCP）服务器，为Claude Desktop提供Google Drive集成功能，并配备专门用于分析高性能计算（HPC）日志文件的工具。

概述

这款MCP服务器使Claude能够直接访问您的Google Drive文件，并智能分析高性能计算（HPC）作业日志，帮助您在不离开Claude桌面界面的情况下，快速识别错误、警告和资源问题。

特点/特性

• Google Drive 集成直接在Google Drive中搜索、列出并阅读文件
• 高性能计算（HPC）日志分析自动检测常见的高性能计算（HPC）问题：

- 内存不足（OOM）错误 - 作业超时和时间限制问题 - 失败的任务和致命错误 - 资源分配问题

• 智能搜索快速在您的云端硬盘中查找日志文件（.log、.out、.err）
• 只读访问安全、只读访问您的Google云端硬盘
• 持续认证一次性OAuth设置，支持自动令牌刷新

先决条件

• Python 3.7及以上版本
• Claude Desktop已安装
• Google Cloud 账户（免费套餐即可满足需求）
• 用于包管理的pip

快速入门

1. 克隆仓库

git clone https://github.com/minitim222/gdrive_hpc_mcp.git
cd gdrive_hpc_mcp

2. 安装依赖项

pip install -r requirements.txt

3. 设置Google Cloud凭据

遵循详细步骤 SETUP_GUIDE.md 翻译为中文是：“安装指南.md” 或 “设置指南.md”。（注：在文件名中，".md" 通常表示这是一个 Markdown 格式的文件，因此在中文语境下，我们通常会保留 ".md" 不译，直接翻译文件名的其余部分。） 收件人：

1. 创建一个Google Cloud项目
2. 启用Google Drive API
3. 下载OAuth凭据为 credentials.json

4. 配置Claude桌面版

运行自动配置脚本：

python configure_claude.py

或者手动编辑 ~/Library/Application Support/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "gdrive-hpc": {
      "command": "python",
      "args": ["/absolute/path/to/gdrive_hpc_mcp/server.py"]
    }
  }
}

5. 验证

运行一次服务器进行身份验证：

python server.py

这将打开您的浏览器以进行Google OAuth身份验证。

6. 重启Claude桌面版

退出并重新启动 Claude 桌面应用。查找 🔌 图标以确认 MCP 服务器已加载。

使用示例

一旦设置好，你可以向Claude询问诸如：

"Search for log files in my Google Drive"

"Analyze the latest job.log file and tell me why it failed"

"Find all HPC logs from last week"

"Read the error log from my simulations folder"

可用工具

MCP服务器为Claude提供了这些工具：

list_drive_files

在Google Drive中搜索并列出文件，可选择使用查询和文件夹过滤。

参数：

• query (str): 搜索查询（例如，“名称包含'log'”）
• max_results (int): 最大结果数量（默认：10）
• folder_id (字符串，可选)：要搜索的特定文件夹ID

read_drive_file

从Google Drive中读取文件内容。

参数：

• file_id (str): Google Drive 文件ID

analyze_hpc_log

分析高性能计算（HPC）日志文件并提供见解。

参数：

• file_id (字符串): 日志文件的Google Drive文件ID

返回：

• 文件元数据（名称、大小、行数）
• 发现的错误列表
• 发现的警告列表
• 针对问题提出的可操作性建议

search_hpc_logs

特别搜索高性能计算（HPC）日志文件（扩展名为.log、.out、.err）。

参数：

• search_term (str): 搜索词（默认： "\*.log"）
• folder_id (str, 可选): 要搜索的文件夹
• max_results (int): 最大结果数（默认：20）

安全

• 只读访问服务器仅请求对Google Drive的读取权限
• 本地凭据所有认证令牌都存储在您本地的机器上
• 无第三方访问权限您的Google Drive数据由本地运行的Claude直接访问
• 被 Git 忽略的密钥/秘密: credentials.json 和 token.pickle 被排除在版本控制之外

重要的永远不要提交（代码/更改） credentials.json 或者 token.pickle 到公共仓库。

文件结构

gdrive_hpc_mcp/
├── server.py              # Main MCP server
├── configure_claude.py    # Claude Desktop config helper
├── test_auth.py          # Authentication test script
├── install.sh            # Installation script
├── requirements.txt      # Python dependencies
├── SETUP_GUIDE.md       # Detailed setup instructions
├── README.md            # This file
├── .gitignore           # Excludes credentials
└── credentials.json     # Your OAuth credentials (not in repo)

故障排除

"未找到 credentials.json 文件"

确保您已从 Google Cloud Console 下载了 OAuth 客户端凭据，并将其放置在项目目录中。

“模块未找到”错误

安装依赖项： pip install -r requirements.txt

MCP工具未出现在Claude中

• 验证 claude_desktop_config.json 语法是有效的JSON
• 检查文件路径是否为绝对路径，而非相对路径
• 完全重启Claude桌面版

认证问题

删除 token.pickle 并运行 python server.py 重新进行身份验证。

看 SETUP_GUIDE.md 翻译为中文是：“安装指南.md” 以便进行更详细的故障排除。

发展

测试认证

python test_auth.py

直接运行服务器

python server.py

做出贡献

欢迎投稿！请随时：

• 报告错误
• 建议新功能
• 提交拉取请求

许可证

MIT 许可证 - 请随意使用并根据需要进行修改。

资源

• 模型上下文协议文档
• Claude Desktop（可译为“Claude桌面版”或保持原样，根据上下文判断是否需要具体化为某种软件或应用的名称）
• 谷歌云端硬盘API文档
• FastMCP框架

致谢

使用……构建 FastMCP - 一个用于创建MCP服务器的Python框架。