{"_id":"@ballast-sh/bridge","_rev":"4-3154ead60f781f6a4fda0d8a23d254a5","name":"@ballast-sh/bridge","dist-tags":{"latest":"0.0.5"},"versions":{"0.0.1":{"name":"@ballast-sh/bridge","version":"0.0.1","keywords":["mcp","ballast","bridge","model-context-protocol","claude"],"author":"","license":"MIT","_id":"@ballast-sh/bridge@0.0.1","maintainers":[{"name":"localrivet","email":"npm@k8scommerce.com"}],"bin":{"ballast-bridge":"dist/index.js"},"dist":{"shasum":"ab048c123768c58291068aba9e85388a675b8c8f","tarball":"https://registry.npmjs.org/@ballast-sh/bridge/-/bridge-0.0.1.tgz","fileCount":11,"integrity":"sha512-C3sBuMzbKLk/CWxCJ81HrTU3nd3APK3sFjxg/OtK+RmHTl75y7QqjrxVBrX+j7663fls8LwCw7UNTsqUwt5MHQ==","signatures":[{"sig":"MEYCIQChnel2S2YAdyJd/XTUCbcz6KAmz7+okCmEKAcRhUSWmwIhAOkiWds5ydZ4+j54jNOdp9lXmOxSiFOiuATSl9kP2z2s","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":36257},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"gitHead":"7213f182daac4ea3e4daa6af202deaaa162a4eeb","scripts":{"build":"tsc","prepublishOnly":"npm run build"},"_npmUser":{"name":"localrivet","email":"npm@k8scommerce.com"},"_npmVersion":"10.9.3","description":"MCP bridge connecting Claude Desktop to Ballast collections","directories":{},"_nodeVersion":"22.19.0","dependencies":{"commander":"^12.0.0","node-fetch":"^3.3.2","@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.3.3","@types/node":"^20.11.0"},"_npmOperationalInternal":{"tmp":"tmp/bridge_0.0.1_1765409254890_0.7818640596892277","host":"s3://npm-registry-packages-npm-production"}},"0.0.2":{"name":"@ballast-sh/bridge","version":"0.0.2","keywords":["mcp","ballast","bridge","model-context-protocol","claude","proxy"],"author":"","license":"MIT","_id":"@ballast-sh/bridge@0.0.2","maintainers":[{"name":"localrivet","email":"npm@k8scommerce.com"}],"bin":{"ballast-bridge":"dist/index.js"},"dist":{"shasum":"719e4466e683d11bc2482d5cef0d48af365da1b6","tarball":"https://registry.npmjs.org/@ballast-sh/bridge/-/bridge-0.0.2.tgz","fileCount":9,"integrity":"sha512-jjmKhHk1x85R/6F23wM2MJTd8k9ezpCN5JLFgOKe8SHNpsUg2Q5oYg5IjK5culicvrj2mV8t6hdVsXwzp95utA==","signatures":[{"sig":"MEYCIQCRNwy1O6FynJRs6q9PT3dszRcq3MLLuxLENthoaqBkwAIhAP1fEyc4LaxIPeWeaPz2uU1Ea28J0ZJqIbEYPqrpl9MX","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":25757},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"gitHead":"7213f182daac4ea3e4daa6af202deaaa162a4eeb","scripts":{"build":"tsc","prepublishOnly":"npm run build"},"_npmUser":{"name":"localrivet","email":"npm@k8scommerce.com"},"_npmVersion":"10.9.3","description":"stdio-to-SSE MCP proxy for connecting Claude Desktop to Ballast","directories":{},"_nodeVersion":"22.19.0","dependencies":{"commander":"^12.0.0","@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.3.3","@types/node":"^20.11.0"},"_npmOperationalInternal":{"tmp":"tmp/bridge_0.0.2_1765411345164_0.4946685783409728","host":"s3://npm-registry-packages-npm-production"}},"0.0.3":{"name":"@ballast-sh/bridge","version":"0.0.3","keywords":["mcp","ballast","bridge","model-context-protocol","claude","proxy"],"author":"","license":"MIT","_id":"@ballast-sh/bridge@0.0.3","maintainers":[{"name":"localrivet","email":"npm@k8scommerce.com"}],"bin":{"ballast-bridge":"dist/index.js"},"dist":{"shasum":"37383bb63364e6609866d7022bfbb166da104844","tarball":"https://registry.npmjs.org/@ballast-sh/bridge/-/bridge-0.0.3.tgz","fileCount":9,"integrity":"sha512-4uHiAN2HuGnRmtkuOax3ioyogRQnshUwgkIdQQy0E0L1ZWQ17WeWQ4ufo7qW/orFugoIo4Ybf18XKEmrNktx5Q==","signatures":[{"sig":"MEUCIQCeo0OTeg1hK35VaMrZ4UxRjoZ7ytTeU91t6rUCvvyyawIgCfKORvWC01364dMxZQCiGlswyWPlkTag7fPzYsLYFPY=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":25968},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"gitHead":"7213f182daac4ea3e4daa6af202deaaa162a4eeb","scripts":{"build":"tsc","prepublishOnly":"npm run build"},"_npmUser":{"name":"localrivet","email":"npm@k8scommerce.com"},"_npmVersion":"10.9.3","description":"stdio-to-StreamableHTTP MCP proxy for connecting Claude Desktop to Ballast","directories":{},"_nodeVersion":"22.19.0","dependencies":{"commander":"^12.0.0","@modelcontextprotocol/sdk":"^1.10.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.3.3","@types/node":"^20.11.0"},"_npmOperationalInternal":{"tmp":"tmp/bridge_0.0.3_1765412314783_0.747154960564457","host":"s3://npm-registry-packages-npm-production"}},"0.0.5":{"name":"@ballast-sh/bridge","version":"0.0.5","description":"Transparent stdio-to-StreamableHTTP MCP proxy for connecting Claude Desktop to Ballast","main":"dist/index.js","bin":{"ballast-bridge":"dist/index.js"},"type":"module","scripts":{"build":"tsc","prepublishOnly":"npm run build"},"keywords":["mcp","ballast","bridge","model-context-protocol","claude","proxy"],"author":"","license":"MIT","dependencies":{"commander":"^12.0.0"},"devDependencies":{"@types/node":"^20.11.0","typescript":"^5.3.3"},"engines":{"node":">=18"},"_id":"@ballast-sh/bridge@0.0.5","gitHead":"7213f182daac4ea3e4daa6af202deaaa162a4eeb","types":"./dist/index.d.ts","_nodeVersion":"22.19.0","_npmVersion":"10.9.3","dist":{"integrity":"sha512-qhtq7S6HeYnzL7xht04ulFB/2gKT8IpiLosV+8T3JQzmmzftRVszHLqeb+9HJIRfBUYDmkJAaBwyQ9Gv9LeN9g==","shasum":"8b2af3f35e0387450dd332c36057788e9601c1d6","tarball":"https://registry.npmjs.org/@ballast-sh/bridge/-/bridge-0.0.5.tgz","fileCount":9,"unpackedSize":25331,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDruUJ7nd2b85NZD4AwxLRbhSXi3JhJ9JZcal3d6qkKRQIgcazWyE+hdJ7YirmYJJJgkjEP4DpFLCTlzlS+JxNervw="}]},"_npmUser":{"name":"localrivet","email":"npm@k8scommerce.com"},"directories":{},"maintainers":[{"name":"localrivet","email":"npm@k8scommerce.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/bridge_0.0.5_1765421984081_0.18960798023130443"},"_hasShrinkwrap":false}},"time":{"created":"2025-12-10T23:27:34.817Z","modified":"2025-12-11T02:59:44.448Z","0.0.1":"2025-12-10T23:27:35.044Z","0.0.2":"2025-12-11T00:02:25.320Z","0.0.3":"2025-12-11T00:18:34.922Z","0.0.5":"2025-12-11T02:59:44.227Z"},"license":"MIT","keywords":["mcp","ballast","bridge","model-context-protocol","claude","proxy"],"description":"Transparent stdio-to-StreamableHTTP MCP proxy for connecting Claude Desktop to Ballast","maintainers":[{"name":"localrivet","email":"npm@k8scommerce.com"}],"readme":"# @ballast-sh/bridge\n\nMCP bridge connecting Claude Desktop to Ballast collections.\n\n## Installation\n\n```bash\nnpm install -g @ballast-sh/bridge\n```\n\nOr use with `npx` (no installation required):\n\n```bash\nnpx @ballast-sh/bridge --collection your-collection-name\n```\n\n## Usage\n\n### Claude Desktop Configuration\n\nAdd to your `claude_desktop_config.json`:\n\n**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`\n**Windows**: `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"ballast\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@ballast-sh/bridge\", \"--collection\", \"your-collection-name\"],\n      \"env\": {\n        \"BALLAST_API_KEY\": \"your-api-key-here\"\n      }\n    }\n  }\n}\n```\n\nFor custom Ballast deployment:\n\n```json\n{\n  \"mcpServers\": {\n    \"ballast\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"-y\", \n        \"@ballast-sh/bridge\", \n        \"--collection\", \"your-collection-name\",\n        \"--base-url\", \"https://your-ballast-instance.com\"\n      ],\n      \"env\": {\n        \"BALLAST_API_KEY\": \"your-api-key-here\"\n      }\n    }\n  }\n}\n```\n\n### Restart Claude Desktop\n\nAfter updating the config, restart Claude Desktop to load the MCP server.\n\n## Available Tools\n\nOnce connected, Claude can use these tools:\n\n- **search**: Search through your Ballast collection\n- **list_sources**: List all data sources in the collection\n- **trigger_sync**: Trigger a data sync\n- **get_collection_info**: Get collection information\n\n## Development\n\n```bash\n# Clone and install\ngit clone <repo>\ncd bridge\nnpm install\n\n# Build\nnpm run build\n\n# Test locally\nnode dist/index.js --collection test-collection\n```\n\n## Environment Variables\n\n- `BALLAST_API_KEY` (required): Your Ballast API key\n\n## Command Line Options\n\n- `--collection <n>` (required): Collection name\n- `--base-url <url>`: Ballast base URL (default: http://localhost:5173)\n\n## Example Usage in Claude\n\nOnce configured, you can ask Claude:\n\n> \"Search my marketing-db collection for recent data\"\n\n> \"List all data sources in my Ballast collection\"\n\n> \"Trigger a sync for my collection\"\n\n## License\n\nMIT\n","readmeFilename":"README.md"}