mcp-cohesity

A Model Context Protocol (MCP) server for Cohesity DataProtect, providing AI assistants with full access to backup management, recovery operations, and data protection monitoring through the Cohesity REST API.

Features

14 tools across six categories:

Cluster

Protection Policies & Groups

Backup Runs

Protection Sources

Recovery

Alerts

Installation

git clone git@github.com:fredriksknese/mcp-cohesity.git
cd mcp-cohesity
npm install
npm run build

Configuration

The server is configured via environment variables:

Usage with Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "cohesity": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-cohesity/dist/index.js"],
      "env": {
        "COHESITY_CLUSTER": "your-cohesity-cluster.example.com",
        "COHESITY_USERNAME": "admin",
        "COHESITY_PASSWORD": "your-password",
        "COHESITY_DOMAIN": "LOCAL"
      }
    }
  }
}

Usage with Claude Code

Add to your Claude Code MCP settings:

claude mcp add cohesity -- node /absolute/path/to/mcp-cohesity/dist/index.js

Set the required environment variables before running, or configure them in your MCP settings.

Example Prompts

Once connected, you can ask your AI assistant things like:

• "Show me the current cluster storage utilization"
• "List all protection groups that failed their last backup"
• "Trigger an on-demand backup for the VM production group"
• "What are the critical alerts on the cluster right now?"
• "Show me all backup runs in the last 24 hours"
• "List all VMware protection sources registered on the cluster"
• "Get the details of the last backup run for protection group ID 12345"
• "Resolve alert ID abc123 — disk was replaced"
• "What recovery tasks are currently running?"
• "List all protection policies and their retention settings"

Development

npm run dev      # Run with tsx (auto-reloads)
npm run build    # Compile TypeScript to dist/
npm start        # Run compiled output

Architecture

src/
├── index.ts              # Entry point — creates MCP server + STDIO transport
├── cohesity-client.ts    # HTTP client with token-based auth and V1/V2 API support
└── tools/
    ├── cluster.ts        # Cluster info and stats (2 tools)
    ├── protection.ts     # Protection policies and groups (4 tools)
    ├── runs.ts           # Backup run management (2 tools)
    ├── sources.ts        # Protection source management (2 tools)
    ├── recovery.ts       # Recovery task management (2 tools)
    └── alerts.ts         # Alert management (2 tools)

API Details

This server uses two Cohesity API versions:

• V2 API (/v2/) — Used for protection groups, runs, sources, and recoveries
• V1 API (/irisservices/api/v1/public/) — Used for alerts and source hierarchy

Authentication uses the V2 sessions endpoint (POST /v2/users/sessions) with Bearer token auth. Tokens are automatically refreshed on expiry.

Requirements

• Node.js 18+
• Cohesity DataProtect cluster with REST API access (tested with Cohesity 6.x+)

License

SEE LICENSE IN LICENSE