Skip to main content
Glama

Google Drive HPC Log Analyzer

by minitim222
GitHub
Python
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Google Drive HPC Log Analyzer

A Model Context Protocol (MCP) server that brings Google Drive integration to Claude Desktop, with specialized tools for analyzing High Performance Computing (HPC) log files.

Overview

This MCP server enables Claude to directly access your Google Drive files and intelligently analyze HPC job logs, helping you quickly identify errors, warnings, and resource issues without leaving the Claude Desktop interface.

Features

  • Google Drive Integration: Search, list, and read files directly from Google Drive

  • HPC Log Analysis: Automatic detection of common HPC issues:

    • Out of memory (OOM) errors

    • Job timeouts and time limit issues

    • Failed jobs and fatal errors

    • Resource allocation problems

  • Smart Search: Quickly find log files (.log, .out, .err) across your Drive

  • Read-Only Access: Secure, read-only access to your Google Drive

  • Persistent Authentication: One-time OAuth setup with automatic token refresh

Prerequisites

  • Python 3.7+

  • Claude Desktop installed

  • Google Cloud account (free tier works fine)

  • pip for package management

Quick Start

1. Clone the Repository

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

2. Install Dependencies

pip install -r requirements.txt

3. Set Up Google Cloud Credentials

Follow the detailed SETUP_GUIDE.md to:

  1. Create a Google Cloud project

  2. Enable the Google Drive API

  3. Download OAuth credentials as credentials.json

4. Configure Claude Desktop

Run the automatic configuration script:

python configure_claude.py

Or manually edit ~/Library/Application Support/Claude/claude_desktop_config.json:

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

5. Authenticate

Run the server once to authenticate:

python server.py

This will open your browser for Google OAuth authentication.

6. Restart Claude Desktop

Quit and restart Claude Desktop. Look for the šŸ”Œ icon to confirm the MCP server is loaded.

Usage Examples

Once set up, you can ask Claude things like:

"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"

Available Tools

The MCP server provides these tools to Claude:

list_drive_files

Search and list files in Google Drive with optional queries and folder filtering.

Parameters:

  • query (str): Search query (e.g., "name contains 'log'")

  • max_results (int): Maximum number of results (default: 10)

  • folder_id (str, optional): Specific folder ID to search within

read_drive_file

Read the contents of a file from Google Drive.

Parameters:

  • file_id (str): Google Drive file ID

analyze_hpc_log

Analyze an HPC log file and provide insights.

Parameters:

  • file_id (str): Google Drive file ID of the log file

Returns:

  • File metadata (name, size, line count)

  • List of errors found

  • List of warnings found

  • Actionable suggestions for fixing issues

search_hpc_logs

Search specifically for HPC log files (.log, .out, .err extensions).

Parameters:

  • search_term (str): Search term (default: "*.log")

  • folder_id (str, optional): Folder to search within

  • max_results (int): Maximum results (default: 20)

Security

  • Read-Only Access: The server only requests read permissions to Google Drive

  • Local Credentials: All authentication tokens are stored locally on your machine

  • No Third-Party Access: Your Google Drive data is accessed directly by Claude running locally

  • Gitignored Secrets: credentials.json and token.pickle are excluded from version control

Important: Never commit credentials.json or token.pickle to public repositories.

File Structure

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)

Troubleshooting

"credentials.json not found"

Make sure you've downloaded the OAuth client credentials from Google Cloud Console and placed them in the project directory.

"Module not found" errors

Install dependencies: pip install -r requirements.txt

MCP tools don't appear in Claude

  • Verify claude_desktop_config.json syntax is valid JSON

  • Check that the file path is absolute, not relative

  • Restart Claude Desktop completely

Authentication issues

Delete token.pickle and run python server.py to re-authenticate.

See SETUP_GUIDE.md for more detailed troubleshooting.

Development

Testing Authentication

python test_auth.py

Running the Server Directly

python server.py

Contributing

Contributions are welcome! Feel free to:

  • Report bugs

  • Suggest new features

  • Submit pull requests

License

MIT License - feel free to use and modify as needed.

Resources

Acknowledgments

Built with FastMCP - a Python framework for creating MCP servers.

This server cannot be installed

-
security - not tested
F
license - not found
-
quality - not tested

How are these scores calculated?

local-only server

The server can only run on the client's local machine because it depends on local resources.

Enables Claude to directly access Google Drive files and analyze High Performance Computing (HPC) log files. Automatically detects common HPC issues like memory errors, job timeouts, and resource allocation problems.

  1. Overview
    1. Features
      1. Prerequisites
        1. Quick Start
          1. 1. Clone the Repository
          2. 2. Install Dependencies
          3. 3. Set Up Google Cloud Credentials
          4. 4. Configure Claude Desktop
          5. 5. Authenticate
          6. 6. Restart Claude Desktop
        2. Usage Examples
          1. Available Tools
            1. list_drive_files
            2. read_drive_file
            3. analyze_hpc_log
            4. search_hpc_logs
          2. Security
            1. File Structure
              1. Troubleshooting
                1. "credentials.json not found"
                2. "Module not found" errors
                3. MCP tools don't appear in Claude
                4. Authentication issues
              2. Development
                1. Testing Authentication
                2. Running the Server Directly
              3. Contributing
                1. License
                  1. Resources
                    1. Acknowledgments

                      New MCP Servers

                      MCP directory API

                      We provide all the information about MCP servers via our MCP API.

                      curl -X GET 'https://glama.ai/api/mcp/v1/servers/minitim222/gdrive_hpc_mcp'

                      If you have feedback or need assistance with the MCP directory API, please join our Discord server