PSR Cloud MCP Server

MCP server that exposes PSR Cloud HPC operations as AI tools, built on top of pycloud (psr-cloud on PyPI).

Prerequisites

1. Python 3.10+
2. A Personal Access Token from PSR Cloud:
   • Go to sso.psr-inc.com/profile
   • Log in with your corporate PSR Google account
   • Generate a token under PSR Cloud — Personal Access Tokens
   • Save the token value (shown only once)

Installation

From PyPI

pip install psr-cloud-mcp

From the Git repository

pip install git+https://github.com/your-org/psr-cloud-mcp.git

Local development clone

git clone https://github.com/your-org/psr-cloud-mcp.git
cd psr-cloud-mcp/local
pip install -e .

Configuring Claude Code

Add to ~/.claude/settings.json (or settings.local.json for local-only):

{
  "mcpServers": {
    "psr-cloud": {
      "command": "psr-cloud-mcp",
      "env": {
        "PSR_CLOUD_EMAIL": "yourname@psr-inc.com",
        "PSR_CLOUD_ACCESS_TOKEN": "<your-token>"
      }
    }
  }
}

If you prefer not to store the token in the config file, omit the env block and set the variables in your shell profile instead.

Configuring Claude Desktop

Open the Claude Desktop config file:

• Windows: %APPDATA%\Claude\claude_desktop_config.json
• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Add the psr-cloud entry under mcpServers:

{
  "mcpServers": {
    "psr-cloud": {
      "command": "psr-cloud-mcp",
      "env": {
        "PSR_CLOUD_EMAIL": "yourname@psr-inc.com",
        "PSR_CLOUD_ACCESS_TOKEN": "<your-token>"
      }
    }
  }
}

If psr-cloud-mcp is not on the system PATH (common on Windows), use the full path to the executable:

{
  "mcpServers": {
    "psr-cloud": {
      "command": "C:\\Users\\<user>\\AppData\\Local\\Programs\\Python\\Python3xx\\Scripts\\psr-cloud-mcp.exe",
      "env": {
        "PSR_CLOUD_EMAIL": "yourname@psr-inc.com",
        "PSR_CLOUD_ACCESS_TOKEN": "<your-token>"
      }
    }
  }
}

To find the exact executable path on Windows, run:

where.exe psr-cloud-mcp

After saving the file, restart Claude Desktop. The PSR Cloud tools will appear in the tools panel (hammer icon).

Available tools

Choosing a cluster

Every cluster-scoped tool above accepts an optional cluster argument. Omit it to use your account's default cluster — the right choice for most users. Pass a name (run list_clusters to see them) to operate against a specific cluster; unknown names are rejected with the list of valid options.

Typical AI workflow

get_programs()
  → get_program_versions("SDDP")
  → get_execution_types("SDDP", "18.0")
  → run_case(name="my-run", data_path="/path/to/data", program="SDDP", ...)
  → get_case_status(case_id)         # poll until SUCCESS
  → list_case_files(case_id)
  → download_case_files(case_id, output_path="/path/to/results")  # returns job_id
  → get_download_status(job_id)      # poll until status is "done"