{"_id":"@aidalinfo/ovhcloud-mcp","_rev":"2-9045d1f9b640f69f7196a9a12f78e4a2","name":"@aidalinfo/ovhcloud-mcp","dist-tags":{"latest":"2.1.1"},"versions":{"2.1.0":{"name":"@aidalinfo/ovhcloud-mcp","version":"2.1.0","keywords":["mcp","mcp-server","ovhcloud","ovh","vps","domains","dns","typescript"],"author":{"url":"upstream","name":"Hleb Tkachenko"},"license":"MIT","_id":"@aidalinfo/ovhcloud-mcp@2.1.0","maintainers":[{"name":"aidalinfo","email":"dev@pulsemyit.fr"}],"homepage":"https://github.com/hlebtkachenko/ovhcloud-mcp#readme","bugs":{"url":"https://github.com/aidalinfo/cloud-mcp/issues"},"bin":{"ovhcloud-mcp":"dist/index.js"},"dist":{"shasum":"94cb528b8a98da0a5dcf26d5f9140add02cbad25","tarball":"https://registry.npmjs.org/@aidalinfo/ovhcloud-mcp/-/ovhcloud-mcp-2.1.0.tgz","fileCount":13,"integrity":"sha512-M+nbhaTIJw5oZXE/+QeVq4gBxpXLv/ay6AkD8CncWnJLbGMuivcLPtt0k/SpQYQenNJdZ9h5QZI2Q+SgynTQjQ==","signatures":[{"sig":"MEYCIQCBzz7qdOHfPnlo89Je35QuesBpjW3gsFNaIga/ajbSAAIhAM8oQEkZRatE+vXaHyZHOraKJKrwCGlsNhXDqAccqjCA","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":58543},"main":"dist/index.js","type":"module","engines":{"node":">=20"},"gitHead":"4f3981a565ec12ae934a7950b10b72fbbcca533b","scripts":{"test":"NODE_OPTIONS=--experimental-vm-modules jest","build":"tsc","start":"node dist/index.js","prepack":"npm run build"},"_npmUser":{"name":"aidalinfo","email":"dev@pulsemyit.fr"},"repository":{"url":"git+https://github.com/aidalinfo/cloud-mcp.git","type":"git","directory":"packages/ovhcloud-mcp"},"_npmVersion":"10.9.8","description":"OVHcloud MCP server (Aidalinfo fork of hlebtkachenko/ovhcloud-mcp) — VPS, Public Cloud, domains, DNS, billing, SSH, API explorer","directories":{},"_nodeVersion":"22.22.3","dependencies":{"zod":"^4.4.3","ssh2":"^1.17.0","@modelcontextprotocol/sdk":"^1.27.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"jest":"^30.3.0","ts-jest":"^29.4.6","typescript":"^5.7.0","@types/node":"^22.0.0","@types/ssh2":"^1.15.5","@jest/globals":"^30.3.0"},"_npmOperationalInternal":{"tmp":"tmp/ovhcloud-mcp_2.1.0_1781094439176_0.7180033552147949","host":"s3://npm-registry-packages-npm-production"}},"2.1.1":{"name":"@aidalinfo/ovhcloud-mcp","version":"2.1.1","description":"OVHcloud MCP server (Aidalinfo fork of hlebtkachenko/ovhcloud-mcp) — VPS, Public Cloud, domains, DNS, billing, SSH, API explorer","type":"module","main":"dist/index.js","bin":{"ovhcloud-mcp":"dist/index.js"},"publishConfig":{"access":"public"},"license":"MIT","author":{"name":"Hleb Tkachenko","url":"upstream"},"repository":{"type":"git","url":"git+https://github.com/aidalinfo/cloud-mcp.git","directory":"packages/ovhcloud-mcp"},"homepage":"https://github.com/hlebtkachenko/ovhcloud-mcp#readme","engines":{"node":">=20"},"keywords":["mcp","mcp-server","ovhcloud","ovh","vps","domains","dns","typescript"],"scripts":{"build":"tsc","prepack":"npm run build","start":"node dist/index.js","test":"NODE_OPTIONS=--experimental-vm-modules jest"},"dependencies":{"@modelcontextprotocol/sdk":"^1.27.0","ssh2":"^1.17.0","zod":"^4.4.3"},"devDependencies":{"@jest/globals":"^30.3.0","@types/node":"^22.0.0","@types/ssh2":"^1.15.5","jest":"^30.3.0","ts-jest":"^29.4.6","typescript":"^5.7.0"},"_id":"@aidalinfo/ovhcloud-mcp@2.1.1","gitHead":"516f51b876e35950de7d916eb20abce92756700a","bugs":{"url":"https://github.com/aidalinfo/cloud-mcp/issues"},"_nodeVersion":"22.22.3","_npmVersion":"10.9.8","dist":{"integrity":"sha512-S46kxFZcRs8s6t9tvKBVb0qy2GLzNyNomEc2teN/NIxbYjwosM4v8VAa6OMFhVQYtHeyTMEMZKyEv6uEUG8FTw==","shasum":"a013a3aa4f3029b64bcac4327c3989d2b42618ec","tarball":"https://registry.npmjs.org/@aidalinfo/ovhcloud-mcp/-/ovhcloud-mcp-2.1.1.tgz","fileCount":13,"unpackedSize":58548,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQC4VMqsVr2IXnxA9QWEM2b4O7rEgEzoEH1jxO8EE8DISQIhAPTQZe10TvJnt5dXwT0yacHKqD79QpDzJf89/r5PSOYj"}]},"_npmUser":{"name":"aidalinfo","email":"dev@pulsemyit.fr"},"directories":{},"maintainers":[{"name":"aidalinfo","email":"dev@pulsemyit.fr"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/ovhcloud-mcp_2.1.1_1781123800899_0.6357833404350304"},"_hasShrinkwrap":false}},"time":{"created":"2026-06-10T12:27:18.969Z","modified":"2026-06-10T20:36:41.209Z","2.1.0":"2026-06-10T12:27:19.321Z","2.1.1":"2026-06-10T20:36:41.104Z"},"bugs":{"url":"https://github.com/aidalinfo/cloud-mcp/issues"},"author":{"name":"Hleb Tkachenko","url":"upstream"},"license":"MIT","homepage":"https://github.com/hlebtkachenko/ovhcloud-mcp#readme","keywords":["mcp","mcp-server","ovhcloud","ovh","vps","domains","dns","typescript"],"repository":{"type":"git","url":"git+https://github.com/aidalinfo/cloud-mcp.git","directory":"packages/ovhcloud-mcp"},"description":"OVHcloud MCP server (Aidalinfo fork of hlebtkachenko/ovhcloud-mcp) — VPS, Public Cloud, domains, DNS, billing, SSH, API explorer","maintainers":[{"name":"aidalinfo","email":"dev@pulsemyit.fr"}],"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, Public Cloud projects & instances, domains, DNS, billing, and execute SSH commands from any MCP-compatible client.\n\n35 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/aidalinfo/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\": \"npx\",\n      \"args\": [\"-y\", \"@aidalinfo/ovhcloud-mcp\"],\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\": \"npx\",\n      \"args\": [\"-y\", \"@aidalinfo/ovhcloud-mcp\"],\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\": \"npx\",\n      \"args\": [\"-y\", \"@aidalinfo/ovhcloud-mcp\"],\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```\nnpx -y @aidalinfo/ovhcloud-mcp\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### Public Cloud\n\n| Tool | Description |\n|------|-------------|\n| `ovh_cloud_projects` | List all Public Cloud projects (id, name, status) |\n| `ovh_cloud_project_info` | Project details + region count |\n| `ovh_cloud_instances` | List instances (VMs) — one project or **all projects** |\n| `ovh_cloud_instance_info` | Full VM detail: flavor, image, network |\n| `ovh_cloud_regions` | List regions available in a project |\n| `ovh_cloud_flavors` | List instance flavors (VM sizes), filterable by region |\n| `ovh_cloud_images` | List OS images, filterable by region |\n| `ovh_cloud_volumes` | List storage volumes |\n\n### Domains & 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 & 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    cloud.ts            Public Cloud projects & instances (8 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  cloud.test.ts         Public Cloud tool 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","readmeFilename":"README.md"}