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
| Tool | Description |
|---|---|
get_cluster_info | Get cluster name, ID, software version, and node count |
get_cluster_stats | Get storage capacity (used/total) and throughput statistics |
Protection Policies & Groups
| Tool | Description |
|---|---|
list_protection_policies | List all data protection policies with schedule and retention settings |
list_protection_groups | List protection groups (backup jobs) with status, schedule, and last run info |
get_protection_group | Get detailed configuration of a specific protection group |
run_protection_group | Trigger an on-demand backup run for a protection group |
Backup Runs
| Tool | Description |
|---|---|
list_protection_runs | List recent backup runs with status, duration, and data size |
get_protection_run | Get detailed information about a specific backup run |
Protection Sources
| Tool | Description |
|---|---|
list_sources | List all registered sources (vSphere, Physical, NAS, SQL, etc.) |
get_source | Get full object hierarchy details for a specific source |
Recovery
| Tool | Description |
|---|---|
list_recovery_tasks | List recovery tasks with status and type |
get_recovery_task | Get detailed information about a specific recovery task |
Alerts
| Tool | Description |
|---|---|
list_alerts | List cluster alerts filtered by severity, category, and state |
resolve_alert | Mark an alert as resolved with resolution notes |
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:
| Variable | Required | Default | Description |
|---|---|---|---|
COHESITY_CLUSTER | Yes | — | Cohesity cluster hostname or IP address |
COHESITY_USERNAME | Yes | — | Username for authentication |
COHESITY_PASSWORD | Yes | — | Password for authentication |
COHESITY_DOMAIN | No | LOCAL | Authentication domain |
COHESITY_ALLOW_SELF_SIGNED | No | true | Accept self-signed SSL certificates |
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