{"id":50721452,"url":"https://github.com/hlebtkachenko/ovhcloud-mcp","last_synced_at":"2026-06-10T00:03:37.801Z","repository":{"id":344489696,"uuid":"1181946262","full_name":"hlebtkachenko/ovhcloud-mcp","owner":"hlebtkachenko","description":"MCP server for OVHcloud (www.ovhcloud.com) — VPS, domains, DNS, billing, SSH, API explorer (27 tools)","archived":false,"fork":false,"pushed_at":"2026-03-14T23:37:30.000Z","size":96,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-15T09:23:25.613Z","etag":null,"topics":["dns","mcp","mcp-server","ovh","ovhcloud","typescript","vps"],"latest_commit_sha":null,"homepage":"https://github.hapd.dev/ovhcloud-mcp/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hlebtkachenko.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-14T20:52:47.000Z","updated_at":"2026-03-14T23:37:33.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/hlebtkachenko/ovhcloud-mcp","commit_stats":null,"previous_names":["hlebtkachenko/ovhcloud-mcp"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/hlebtkachenko/ovhcloud-mcp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hlebtkachenko%2Fovhcloud-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hlebtkachenko%2Fovhcloud-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hlebtkachenko%2Fovhcloud-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hlebtkachenko%2Fovhcloud-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hlebtkachenko","download_url":"https://codeload.github.com/hlebtkachenko/ovhcloud-mcp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hlebtkachenko%2Fovhcloud-mcp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34130644,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-09T02:00:06.510Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["dns","mcp","mcp-server","ovh","ovhcloud","typescript","vps"],"created_at":"2026-06-10T00:03:37.733Z","updated_at":"2026-06-10T00:03:37.790Z","avatar_url":"https://github.com/hlebtkachenko.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# OVHcloud MCP Server\n\n![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)\n![Node.js Version](https://img.shields.io/badge/node-%3E%3D20-brightgreen)\n![TypeScript](https://img.shields.io/badge/TypeScript-5-blue)\n\nMCP server for [OVHcloud](https://www.ovhcloud.com). Manage VPS, domains, DNS, billing, and execute SSH commands from any MCP-compatible client.\n\n27 tools + full API discovery across 500+ OVH endpoints.\n\n## Requirements\n\n- Node.js 20+\n- OVH API credentials ([create token](https://www.ovh.com/auth/api/createToken))\n\n## Installation\n\n```bash\ngit clone https://github.com/hlebtkachenko/ovhcloud-mcp.git\ncd ovhcloud-mcp\nnpm ci\nnpm run build\n```\n\n## Configuration\n\n### Cursor\n\n`~/.cursor/mcp.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"ovhcloud\": {\n      \"command\": \"node\",\n      \"args\": [\"/path/to/ovhcloud-mcp/dist/index.js\"],\n      \"env\": {\n        \"OVH_APPLICATION_KEY\": \"your_app_key\",\n        \"OVH_APPLICATION_SECRET\": \"your_app_secret\",\n        \"OVH_CONSUMER_KEY\": \"your_consumer_key\"\n      }\n    }\n  }\n}\n```\n\n### Claude Desktop\n\n`claude_desktop_config.json` ([location](https://modelcontextprotocol.io/quickstart/user#1-open-your-mcp-client))\n\n```json\n{\n  \"mcpServers\": {\n    \"ovhcloud\": {\n      \"command\": \"node\",\n      \"args\": [\"/path/to/ovhcloud-mcp/dist/index.js\"],\n      \"env\": {\n        \"OVH_APPLICATION_KEY\": \"your_app_key\",\n        \"OVH_APPLICATION_SECRET\": \"your_app_secret\",\n        \"OVH_CONSUMER_KEY\": \"your_consumer_key\"\n      }\n    }\n  }\n}\n```\n\n### Claude Code\n\n`.mcp.json` in your project root, or `~/.claude.json` globally:\n\n```json\n{\n  \"mcpServers\": {\n    \"ovhcloud\": {\n      \"command\": \"node\",\n      \"args\": [\"/path/to/ovhcloud-mcp/dist/index.js\"],\n      \"env\": {\n        \"OVH_APPLICATION_KEY\": \"your_app_key\",\n        \"OVH_APPLICATION_SECRET\": \"your_app_secret\",\n        \"OVH_CONSUMER_KEY\": \"your_consumer_key\"\n      }\n    }\n  }\n}\n```\n\n### Any MCP client (stdio)\n\nThe server uses `stdio` transport. Point your MCP client to:\n\n```\nnode /path/to/ovhcloud-mcp/dist/index.js\n```\n\nWith environment variables set for authentication (see below).\n\n### Environment Variables\n\n**Authentication** (one of two modes, auto-detected):\n\n| Variable | Mode | Description |\n|----------|------|-------------|\n| `OVH_APPLICATION_KEY` | API key | Application key |\n| `OVH_APPLICATION_SECRET` | API key | Application secret |\n| `OVH_CONSUMER_KEY` | API key | Consumer key |\n| `OVH_CLIENT_ID` | OAuth2 | Service account ID |\n| `OVH_CLIENT_SECRET` | OAuth2 | Service account secret |\n| `OVH_ENDPOINT` | Both | `ovh-eu` (default), `ovh-ca`, `ovh-us` |\n\n**SSH** (optional):\n\n| Variable | Description |\n|----------|-------------|\n| `SSH_HOST` | Default SSH host |\n| `SSH_PORT` | Default SSH port (default: 22) |\n| `SSH_USER` | Default SSH username |\n| `SSH_PASSWORD` | SSH password |\n| `SSH_PRIVATE_KEY_FILE` | Path to private key file |\n\n## Tools\n\n### VPS\n\n| Tool | Description |\n|------|-------------|\n| `ovh_vps_list` | List all VPS with hardware details |\n| `ovh_vps_info` | Server state, hardware, IPs, service status |\n| `ovh_vps_monitoring` | CPU and network statistics |\n| `ovh_vps_ips` | List assigned IPs |\n| `ovh_vps_reboot` | Reboot a VPS |\n| `ovh_vps_start` | Start a stopped VPS |\n| `ovh_vps_stop` | Stop a running VPS |\n| `ovh_vps_snapshot` | Get snapshot info |\n| `ovh_vps_create_snapshot` | Create a new snapshot |\n\n### Domains \u0026 DNS\n\n| Tool | Description |\n|------|-------------|\n| `ovh_domain_list` | List all domains and DNS zones |\n| `ovh_domain_zone_info` | Nameservers, DNSSEC status |\n| `ovh_domain_dns_records` | List records with type/subdomain filters |\n| `ovh_domain_dns_record_detail` | Single record details |\n| `ovh_domain_dns_create` | Create DNS record |\n| `ovh_domain_dns_update` | Update DNS record |\n| `ovh_domain_dns_delete` | Delete DNS record |\n| `ovh_domain_dns_refresh` | Force zone refresh |\n\n### Account \u0026 Billing\n\n| Tool | Description |\n|------|-------------|\n| `ovh_account_info` | Account details (name, email, country) |\n| `ovh_services` | List active services with renewal info |\n| `ovh_invoices` | Recent invoices with PDF links |\n| `ovh_invoice_detail` | Full invoice with line items |\n\n### API Explorer\n\nDiscover and inspect any OVH API endpoint without writing code.\n\n| Tool | Description |\n|------|-------------|\n| `ovh_api_catalog` | List all API categories (vps, cloud, email, dedicated, etc.) |\n| `ovh_api_search` | Search endpoints by keyword across all or specific categories |\n| `ovh_api_endpoint_detail` | Parameters, types, and descriptions for any endpoint |\n\n### SSH\n\n| Tool | Description |\n|------|-------------|\n| `ovh_ssh_exec` | Execute a command on a remote server |\n| `ovh_ssh_check` | Test SSH connectivity |\n\n### Raw API\n\n| Tool | Description |\n|------|-------------|\n| `ovh_api_raw` | Call any OVH API endpoint directly |\n\n## Docker\n\n```bash\ndocker build -t ovhcloud-mcp .\ndocker run --rm \\\n  -e OVH_APPLICATION_KEY=... \\\n  -e OVH_APPLICATION_SECRET=... \\\n  -e OVH_CONSUMER_KEY=... \\\n  ovhcloud-mcp\n```\n\nMulti-stage build, runs as non-root `node` user.\n\n## Security\n\n- Path injection prevention — `..`, `?`, `#` rejected in API paths\n- 30-second timeout on all HTTP requests\n- Error responses truncated to 500 characters\n- All parameters validated with Zod schemas\n- SSH output capped at 100 KB to prevent memory issues\n- Docker container runs as unprivileged user\n\n## Testing\n\n```bash\nnpm test\n```\n\n## Architecture\n\n```\nsrc/\n  index.ts              Auth detection, tool registration\n  ovh-client.ts         API client (SHA1-HMAC + OAuth2), path validation\n  tools/\n    vps.ts              VPS management (9 tools)\n    domain.ts           Domains and DNS (8 tools)\n    raw.ts              Raw API calls (1 tool)\n    account.ts          Account and billing (4 tools)\n    explorer.ts         API spec search and discovery (3 tools)\n    ssh.ts              Remote command execution (2 tools)\ntests/\n  ovh-client.test.ts    Path validation and client tests\n```\n\n## Tech Stack\n\n- TypeScript\n- `@modelcontextprotocol/sdk`\n- Zod (schema validation)\n- ssh2 (SSH client)\n- Native `fetch`\n\n## API Reference\n\n- [OVH API Console](https://eu.api.ovh.com/console/)\n- [OVH API Documentation](https://docs.ovh.com/gb/en/api/)\n\n## License\n\n[MIT](LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhlebtkachenko%2Fovhcloud-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhlebtkachenko%2Fovhcloud-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhlebtkachenko%2Fovhcloud-mcp/lists"}