{"_id":"@4ears-me/databasus-mcp","name":"@4ears-me/databasus-mcp","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@4ears-me/databasus-mcp","version":"1.0.0","description":"MCP server for controlling Databasus database backup instances","main":"dist/index.js","types":"dist/index.d.ts","bin":{"databasus-mcp":"dist/index.js"},"scripts":{"build":"tsc --project tsconfig.build.json","start":"node dist/index.js","dev":"tsx src/index.ts","test":"vitest run","test:watch":"vitest","test:coverage":"vitest run --coverage"},"keywords":["mcp","databasus","database","backup","postgresql","mysql","mongodb","model-context-protocol","ai","claude"],"author":"","license":"MIT","dependencies":{"@modelcontextprotocol/sdk":"1.26.0","zod":"^3.25.0"},"devDependencies":{"@types/node":"^22.0.0","@vitest/coverage-v8":"^4.0.18","tsx":"^4.0.0","typescript":"^5.0.0","vitest":"^4.0.18"},"repository":{"type":"git","url":"git+https://github.com/4ears-me/databasus-mcp.git"},"homepage":"https://github.com/4ears-me/databasus-mcp#readme","bugs":{"url":"https://github.com/4ears-me/databasus-mcp/issues"},"_id":"@4ears-me/databasus-mcp@1.0.0","gitHead":"eb4b1955dde6f9a9b6edc7052934a5c2c4814a15","_nodeVersion":"22.14.0","_npmVersion":"10.9.2","dist":{"integrity":"sha512-BVCJZYrWJKGQgc4AyjRE+GsXLokuegpFjRTykrPBYlJbk33zQmzsHHcguHRjKYJ4s8FNIcS3EQvhkVh/QyP3Sw==","shasum":"07ca8e3322bd6986e4ce3f27f232dc1664d0f9ad","tarball":"https://registry.npmjs.org/@4ears-me/databasus-mcp/-/databasus-mcp-1.0.0.tgz","fileCount":30,"unpackedSize":216730,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCR8hCNLCCHNFv2+A7tlzr+0WUG3taMTi3PCc9y/0phVAIgAzUcLC6L2Y1KIEMYlaywUilpgqzSrlQhcReXs8nhj4o="}]},"_npmUser":{"name":"btajuddin","email":"brian@briantajuddin.com"},"directories":{},"maintainers":[{"name":"btajuddin","email":"brian@briantajuddin.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/databasus-mcp_1.0.0_1771480758949_0.26408140939497504"},"_hasShrinkwrap":false}},"time":{"created":"2026-02-19T05:59:18.858Z","1.0.0":"2026-02-19T05:59:19.095Z","modified":"2026-02-19T05:59:19.314Z"},"maintainers":[{"name":"btajuddin","email":"brian@briantajuddin.com"}],"description":"MCP server for controlling Databasus database backup instances","homepage":"https://github.com/4ears-me/databasus-mcp#readme","keywords":["mcp","databasus","database","backup","postgresql","mysql","mongodb","model-context-protocol","ai","claude"],"repository":{"type":"git","url":"git+https://github.com/4ears-me/databasus-mcp.git"},"bugs":{"url":"https://github.com/4ears-me/databasus-mcp/issues"},"license":"MIT","readme":"# Databasus MCP\n\nAn MCP (Model Context Protocol) server for controlling Databasus database backup instances. This allows AI assistants like Claude to manage your database backups through natural language.\n\n## Features\n\n- **Database Management**: List, create, update, and delete database backup configurations\n- **Backup Operations**: List backups, trigger manual backups, download and delete backups\n- **Storage Management**: Configure and test backup storage destinations (S3, Google Drive, FTP, etc.)\n- **Notifier Management**: Set up notifications via Slack, Discord, Telegram, Email, webhooks\n- **Health Monitoring**: Check database health status and history\n- **Workspace Management**: View workspaces for team-based access control\n\n## Installation\n\n### Prerequisites\n\n- Node.js 18 or higher\n- A running Databasus instance\n- API key or bearer token from your Databasus instance\n\n### Install via npm\n\n```bash\nnpm install -g @4ears-me/databasus-mcp\n```\n\n### Run directly with npx\n\n```bash\nnpx @4ears-me/databasus-mcp\n```\n\n## Configuration\n\nSet the following environment variables:\n\n| Variable | Required | Description |\n|----------|----------|-------------|\n| `DATABASUS_URL` | Yes | Base URL of your Databasus instance (e.g., `https://backup.example.com`) |\n| `DATABASUS_API_KEY` | No* | API key for authentication |\n| `DATABASUS_BEARER_TOKEN` | No* | Bearer token for authentication |\n\n*Either `DATABASUS_API_KEY` or `DATABASUS_BEARER_TOKEN` is required for authenticated endpoints.\n\n## Usage with Claude Desktop\n\nAdd to your Claude Desktop configuration (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):\n\n```json\n{\n  \"mcpServers\": {\n    \"databasus\": {\n      \"command\": \"npx\",\n      \"args\": [\"@4ears-me/databasus-mcp\"],\n      \"env\": {\n        \"DATABASUS_URL\": \"https://your-databasus-instance.com\",\n        \"DATABASUS_API_KEY\": \"your-api-key\"\n      }\n    }\n  }\n}\n```\n\n## Available Tools\n\n### Database Tools\n- `databasus_list_databases` - List all configured databases\n- `databasus_get_database` - Get details of a specific database\n- `databasus_create_database` - Create a new database backup configuration\n- `databasus_update_database` - Update an existing database configuration\n- `databasus_delete_database` - Delete a database configuration\n- `databasus_trigger_backup` - Manually trigger a backup\n- `databasus_toggle_database` - Enable or disable a database\n\n### Backup Tools\n- `databasus_list_backups` - List all backups (optionally filtered by database)\n- `databasus_get_backup` - Get details of a specific backup\n- `databasus_download_backup` - Get download information for a backup\n- `databasus_delete_backup` - Delete a backup\n- `databasus_get_backup_stats` - Get backup statistics\n\n### Storage Tools\n- `databasus_list_storages` - List all storage destinations\n- `databasus_get_storage` - Get details of a specific storage\n- `databasus_create_storage` - Create a new storage destination\n- `databasus_update_storage` - Update an existing storage\n- `databasus_delete_storage` - Delete a storage destination\n- `databasus_test_storage` - Test storage connection\n\n### Notifier Tools\n- `databasus_list_notifiers` - List all notifiers\n- `databasus_get_notifier` - Get details of a specific notifier\n- `databasus_create_notifier` - Create a new notifier\n- `databasus_update_notifier` - Update an existing notifier\n- `databasus_delete_notifier` - Delete a notifier\n- `databasus_test_notifier` - Test notifier by sending a test notification\n\n### Workspace & Health Tools\n- `databasus_list_workspaces` - List all workspaces\n- `databasus_get_workspace` - Get details of a specific workspace\n- `databasus_get_health_checks` - Get health check history for a database\n- `databasus_get_latest_health` - Get latest health status for a database\n- `databasus_get_stats` - Get overall statistics\n\n## Development\n\n```bash\n# Install dependencies\nnpm install\n\n# Build\nnpm run build\n\n# Run in development mode\nnpm run dev\n\n# Run the built server\nnpm start\n\n# Run tests\nnpm test\n\n# Run tests with coverage\nnpm run test:coverage\n```\n\n## About Databasus\n\n[Databasus](https://databasus.com) is an open-source, self-hosted database backup tool supporting PostgreSQL, MySQL, MariaDB, and MongoDB. It features:\n- Scheduled backups with flexible timing\n- Multiple storage destinations (S3, Google Drive, FTP, etc.)\n- Notifications via Slack, Discord, Telegram, Email\n- AES-256-GCM encryption\n- Team access management\n- Health monitoring\n\n## License\n\nMIT\n","readmeFilename":"README.md","_rev":"1-16236eb1597fbb3725edc352956c0c5a"}