{"_id":"@blaxel/mcp-gateway","_rev":"13-77e54de47c1d45678d8628623a938820","name":"@blaxel/mcp-gateway","dist-tags":{"latest":"0.1.3"},"versions":{"0.0.5":{"name":"@blaxel/mcp-gateway","version":"0.0.5","author":{"url":"https://blaxel.ai","name":"Blaxel, Inc."},"license":"MIT","_id":"@blaxel/mcp-gateway@0.0.5","maintainers":[{"name":"beamlit-cploujoux","email":"cploujoux@beamlit.com"},{"name":"tcrochet","email":"tcrochet@blaxel.ai"},{"name":"cdrappier","email":"cdrappier@blaxel.ai"},{"name":"sugate","email":"mjoffre@blaxel.ai"},{"name":"ch.ploujoux","email":"cploujoux@blaxel.ai"}],"homepage":"https://blaxel.ai","bugs":{"url":"https://github.com/blaxel-ai/mcp-gateway/issues"},"bin":{"mcp-gateway":"dist/index.mjs"},"dist":{"shasum":"b1bfcae6670416b7f964c7be89a6371385307907","tarball":"https://registry.npmjs.org/@blaxel/mcp-gateway/-/mcp-gateway-0.0.5.tgz","fileCount":11,"integrity":"sha512-loX1yZ34hI2eMSWci0MC7KiCkHLXHSWE7alZDcQxAFbGv0KlUwmyrsFhSrB8mDt20/IJHLm+wTBzggzE4StPrA==","signatures":[{"sig":"MEYCIQDow7vD/mkER4b+/s4n2hCzN9UWOfvFqEboa5bZg/JBjgIhAKuWv82ZrK6qalmC4PbczOeHx0wLMY4jkhg/iLK23CZu","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":29883},"main":"dist/index.cjs","type":"module","_from":"file:blaxel-mcp-gateway-0.0.5.tgz","types":"dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","default":"./dist/index.cjs"}},"scripts":{"dev":"tsup --watch","build":"tsup --clean","start":"node dist/index.js --url wss://run.blaxel.ai/main/functions/blaxel-search","prebuild":"pnpm typecheck","typecheck":"tsc --noEmit"},"_npmUser":{"name":"beamlit-cploujoux","email":"cploujoux@beamlit.com"},"_resolved":"/private/var/folders/qp/x78162x52m56q9_b8p6b6psh0000gn/T/2bedcefe1545d57db5c5d643e6c0db62/blaxel-mcp-gateway-0.0.5.tgz","_integrity":"sha512-loX1yZ34hI2eMSWci0MC7KiCkHLXHSWE7alZDcQxAFbGv0KlUwmyrsFhSrB8mDt20/IJHLm+wTBzggzE4StPrA==","repository":{"url":"git+https://github.com/blaxel-ai/mcp-gateway.git","type":"git"},"_npmVersion":"10.9.2","description":"MCP Gateway for Blaxel","directories":{},"sideEffects":false,"_nodeVersion":"23.11.1","dependencies":{"@blaxel/core":"^0.2.31","@modelcontextprotocol/sdk":"^1.17.4"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.5.0","typescript":"^5.6.2","@types/node":"^20.10.0","@total-typescript/tsconfig":"^1.0.4"},"_npmOperationalInternal":{"tmp":"tmp/mcp-gateway_0.0.5_1756481376771_0.22815883372463563","host":"s3://npm-registry-packages-npm-production"}},"0.1.0":{"name":"@blaxel/mcp-gateway","version":"0.1.0","author":{"url":"https://blaxel.ai","name":"Blaxel, Inc."},"license":"MIT","_id":"@blaxel/mcp-gateway@0.1.0","maintainers":[{"name":"beamlit-cploujoux","email":"cploujoux@beamlit.com"},{"name":"tcrochet","email":"tcrochet@blaxel.ai"},{"name":"cdrappier","email":"cdrappier@blaxel.ai"},{"name":"sugate","email":"mjoffre@blaxel.ai"},{"name":"ch.ploujoux","email":"cploujoux@blaxel.ai"}],"homepage":"https://blaxel.ai","bugs":{"url":"https://github.com/blaxel-ai/mcp-gateway/issues"},"bin":{"mcp-gateway":"dist/index.mjs"},"dist":{"shasum":"1eb5154548bb2813d2c6321e37e318309896fe70","tarball":"https://registry.npmjs.org/@blaxel/mcp-gateway/-/mcp-gateway-0.1.0.tgz","fileCount":11,"integrity":"sha512-SUG5LsTF/BrbKACk+GMUAEZ6TieeankU1gNEdc0U+rIO8/LpefB2EPd6kLn6MU6/oJVemzaRXK3Dl+kv6nWbJw==","signatures":[{"sig":"MEQCIFQMgrdg3+03kLeCggy6KKn6YGpCiRyaVUqqW8OqPnScAiBkGWeFcDuourukwHpFlAyg6xjJS2pZkHz/5JeDIFqW8Q==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":29883},"main":"dist/index.cjs","type":"module","_from":"file:blaxel-mcp-gateway-0.1.0.tgz","types":"dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","default":"./dist/index.cjs"}},"scripts":{"dev":"tsup --watch","build":"tsup --clean","start":"node dist/index.js --url wss://run.blaxel.ai/main/functions/blaxel-search","prebuild":"pnpm typecheck","typecheck":"tsc --noEmit"},"_npmUser":{"name":"beamlit-cploujoux","email":"cploujoux@beamlit.com"},"_resolved":"/private/var/folders/qp/x78162x52m56q9_b8p6b6psh0000gn/T/076f5669413c28729fded2e302adbee0/blaxel-mcp-gateway-0.1.0.tgz","_integrity":"sha512-SUG5LsTF/BrbKACk+GMUAEZ6TieeankU1gNEdc0U+rIO8/LpefB2EPd6kLn6MU6/oJVemzaRXK3Dl+kv6nWbJw==","repository":{"url":"git+https://github.com/blaxel-ai/mcp-gateway.git","type":"git"},"_npmVersion":"10.9.2","description":"MCP Gateway for Blaxel","directories":{},"sideEffects":false,"_nodeVersion":"23.11.1","dependencies":{"@blaxel/core":"^0.2.31","@modelcontextprotocol/sdk":"^1.17.4"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.5.0","typescript":"^5.6.2","@types/node":"^20.10.0","@total-typescript/tsconfig":"^1.0.4"},"_npmOperationalInternal":{"tmp":"tmp/mcp-gateway_0.1.0_1756481408843_0.17190019277746593","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@blaxel/mcp-gateway","version":"0.1.1","author":{"url":"https://blaxel.ai","name":"Blaxel, Inc."},"license":"MIT","_id":"@blaxel/mcp-gateway@0.1.1","maintainers":[{"name":"beamlit-cploujoux","email":"cploujoux@beamlit.com"},{"name":"tcrochet","email":"tcrochet@blaxel.ai"},{"name":"cdrappier","email":"cdrappier@blaxel.ai"},{"name":"sugate","email":"mjoffre@blaxel.ai"},{"name":"ch.ploujoux","email":"cploujoux@blaxel.ai"}],"homepage":"https://blaxel.ai","bugs":{"url":"https://github.com/blaxel-ai/mcp-gateway/issues"},"bin":{"mcp-gateway":"dist/index.mjs"},"dist":{"shasum":"be5d150a1b834fa002a469b27ecd930e7a0c521a","tarball":"https://registry.npmjs.org/@blaxel/mcp-gateway/-/mcp-gateway-0.1.1.tgz","fileCount":11,"integrity":"sha512-c9JDrxvMaqsSIepw+hzEs0P/oWd67HX+87w5CDHhV4gk2g/tSqgjFnWNW7PwaDasVd88HevrOlKT5L5vgETjpQ==","signatures":[{"sig":"MEYCIQCGleQKuMguKiuBCcIjxv+0BMmUv60Xg24Z1mx6CFBxcwIhAKQWuMNvSkaZfdeUYEEVy0/S2GqAho+t/BpRaTQw1CJ3","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":60072},"main":"dist/index.cjs","type":"module","types":"dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","default":"./dist/index.cjs"}},"gitHead":"2372dabf1764313aa3d5b595c9cda06595bfa850","scripts":{"dev":"tsup --watch","build":"tsup --clean","start":"node dist/index.js --url wss://run.blaxel.ai/main/functions/blaxel-search","prebuild":"pnpm typecheck","typecheck":"tsc --noEmit","prepublishOnly":"pnpm build"},"_npmUser":{"name":"tcrochet","email":"tcrochet@blaxel.ai"},"repository":{"url":"git+https://github.com/blaxel-ai/mcp-gateway.git","type":"git"},"_npmVersion":"10.7.0","description":"MCP Gateway for Blaxel","directories":{},"sideEffects":false,"_nodeVersion":"20.14.0","dependencies":{"@blaxel/core":"^0.2.31","@modelcontextprotocol/sdk":"^1.17.4"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.5.0","typescript":"^5.6.2","@types/node":"^20.10.0","@total-typescript/tsconfig":"^1.0.4"},"_npmOperationalInternal":{"tmp":"tmp/mcp-gateway_0.1.1_1757063722227_0.5187849167883269","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@blaxel/mcp-gateway","version":"0.1.2","author":{"url":"https://blaxel.ai","name":"Blaxel, Inc."},"license":"MIT","_id":"@blaxel/mcp-gateway@0.1.2","maintainers":[{"name":"beamlit-cploujoux","email":"cploujoux@beamlit.com"},{"name":"tcrochet","email":"tcrochet@blaxel.ai"},{"name":"cdrappier","email":"cdrappier@blaxel.ai"},{"name":"sugate","email":"mjoffre@blaxel.ai"},{"name":"ch.ploujoux","email":"cploujoux@blaxel.ai"}],"homepage":"https://blaxel.ai","bugs":{"url":"https://github.com/blaxel-ai/mcp-gateway/issues"},"bin":{"mcp-gateway":"dist/index.mjs"},"dist":{"shasum":"3fc53908fc60d4f09eb41bdf148b015de6e95012","tarball":"https://registry.npmjs.org/@blaxel/mcp-gateway/-/mcp-gateway-0.1.2.tgz","fileCount":11,"integrity":"sha512-/7BmuLJ6+o2iiNVbn8NBHjUtjAH2luQdEVOVkH/9oaR7ERaGVGJ4ACYLl3syOtF2KzggiEJf6GZQd+XdluWe+w==","signatures":[{"sig":"MEQCIDrfyXXSvWBaoTBhsTdsAKD8FRJeq1zUt9Y3gcOzh1g8AiBcQMj6tGE2JUfbViLysvVc9I8NGo08PaWi55lJ7H8PUw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":70138},"main":"dist/index.cjs","type":"module","types":"dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","default":"./dist/index.cjs"}},"gitHead":"a333ed0cc24f0f00cca2ad83edd1366a9b033d42","scripts":{"dev":"tsup --watch","build":"tsup --clean","start":"node dist/index.js --url wss://run.blaxel.ai/main/functions/blaxel-search","prebuild":"pnpm typecheck","typecheck":"tsc --noEmit","prepublishOnly":"pnpm build"},"_npmUser":{"name":"tcrochet","email":"tcrochet@blaxel.ai"},"repository":{"url":"git+https://github.com/blaxel-ai/mcp-gateway.git","type":"git"},"_npmVersion":"10.7.0","description":"MCP Gateway for Blaxel","directories":{},"sideEffects":false,"_nodeVersion":"20.14.0","dependencies":{"@blaxel/core":"^0.2.31","@modelcontextprotocol/sdk":"^1.17.4"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.5.0","typescript":"^5.6.2","@types/node":"^20.10.0","@total-typescript/tsconfig":"^1.0.4"},"_npmOperationalInternal":{"tmp":"tmp/mcp-gateway_0.1.2_1757066343238_0.3761295950958561","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"@blaxel/mcp-gateway","version":"0.1.3","author":{"url":"https://blaxel.ai","name":"Blaxel, Inc."},"license":"MIT","_id":"@blaxel/mcp-gateway@0.1.3","maintainers":[{"name":"beamlit-cploujoux","email":"cploujoux@beamlit.com"},{"name":"tcrochet","email":"tcrochet@blaxel.ai"},{"name":"cdrappier","email":"cdrappier@blaxel.ai"},{"name":"sugate","email":"mjoffre@blaxel.ai"},{"name":"ch.ploujoux","email":"cploujoux@blaxel.ai"}],"homepage":"https://blaxel.ai","bugs":{"url":"https://github.com/blaxel-ai/mcp-gateway/issues"},"bin":{"mcp-gateway":"dist/index.mjs"},"dist":{"shasum":"98527b938fe66a62dffd8360b899a10d8a44cb6c","tarball":"https://registry.npmjs.org/@blaxel/mcp-gateway/-/mcp-gateway-0.1.3.tgz","fileCount":11,"integrity":"sha512-YnPEE90SrID1g5LFD7vRR33cFHhTeRMjcXO0tgWjDZ1atuVq+zRhSaGqZwy14lcYDUkns5TL8pPfhxx5euSBLw==","signatures":[{"sig":"MEQCIEVkxpaZoxqbgtGdUvRGRMWtCRB++4HldVlVHwO7Sj/tAiBlm5N9WqFOilKOaR9klIKOfJnTee/FRVzZb7wMkwILOQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":35006},"main":"dist/index.cjs","type":"module","types":"dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","default":"./dist/index.cjs"}},"gitHead":"c2d12ef5f6d9aeda030c63f06bcbc0e2a24bc05a","scripts":{"dev":"tsup --watch","build":"tsup --clean","start":"node dist/index.js --url wss://run.blaxel.ai/main/functions/blaxel-search","prebuild":"pnpm typecheck","typecheck":"tsc --noEmit","prepublishOnly":"pnpm build"},"_npmUser":{"name":"tcrochet","email":"tcrochet@blaxel.ai"},"repository":{"url":"git+https://github.com/blaxel-ai/mcp-gateway.git","type":"git"},"_npmVersion":"10.7.0","description":"MCP Gateway for Blaxel","directories":{},"sideEffects":false,"_nodeVersion":"20.14.0","dependencies":{"@blaxel/core":"^0.2.31","@modelcontextprotocol/sdk":"^1.17.4"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.5.0","typescript":"^5.6.2","@types/node":"^20.10.0","@total-typescript/tsconfig":"^1.0.4"},"_npmOperationalInternal":{"tmp":"tmp/mcp-gateway_0.1.3_1757069273811_0.5777247870684052","host":"s3://npm-registry-packages-npm-production"}}},"time":{"created":"2025-08-29T15:29:36.711Z","modified":"2026-09-02T17:57:07.037Z","0.0.1":"2025-08-29T14:50:37.398Z","0.0.2":"2025-08-29T15:02:52.895Z","0.0.3":"2025-08-29T15:12:46.233Z","0.0.4":"2025-08-29T15:23:08.331Z","0.0.5":"2025-08-29T15:29:36.958Z","0.1.0":"2025-08-29T15:30:09.032Z","0.1.1":"2025-09-05T09:15:22.431Z","0.1.2":"2025-09-05T09:59:03.466Z","0.1.3":"2025-09-05T10:47:54.008Z"},"bugs":{"url":"https://github.com/blaxel-ai/mcp-gateway/issues"},"author":{"url":"https://blaxel.ai","name":"Blaxel, Inc."},"license":"MIT","homepage":"https://blaxel.ai","repository":{"url":"git+https://github.com/blaxel-ai/mcp-gateway.git","type":"git"},"description":"MCP Gateway for Blaxel","maintainers":[{"email":"systemsculpt@gmail.com","name":"michaelstolarz"},{"email":"cploujoux@beamlit.com","name":"beamlit-cploujoux"},{"email":"cdrappier@blaxel.ai","name":"cdrappier"},{"email":"mjoffre@blaxel.ai","name":"sugate"},{"email":"cploujoux@blaxel.ai","name":"ch.ploujoux"}],"readme":"# Blaxel MCP Gateway\n\nAn MCP (Model Context Protocol) gateway that connects to Blaxel-hosted MCP servers and exposes them as stdio MCP servers for use in Cursor and other MCP-compatible clients.\n\n## Features\n\n- **Blaxel MCP Integration**: Connect to any MCP server hosted on Blaxel\n- **Stdio Transport**: Exposes Blaxel MCP servers as stdio MCP servers\n- **Automatic Tool Discovery**: Automatically discovers and exposes all tools from the connected MCP server\n- **Cursor Integration**: Ready to use with Cursor and other MCP-compatible clients\n\n## Usage\n\n### Configuration\n\nAdd this to your MCP configuration:\n\n```json\n{\n  \"mcpServers\": {\n    \"blaxel-mcp\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"-y\",\n        \"@blaxel/mcp-gateway@latest\",\n        \"--url\",\n        \"wss://run.blaxel.ai/{YOUR_WORKSPACE}/functions/{YOUR_MCP_SERVER_NAME}\"\n      ]\n    }\n  }\n}\n```\n\n## Prerequisites\n\n- Node.js (version 16 or higher)\n- npm, yarn, or pnpm package manager\n- Blaxel account with deployed MCP servers\n\n## Installation\n\nRun directly with npx (recommended):\n\n```bash\nnpx -y @blaxel/mcp-gateway@latest --url wss://run.blaxel.ai/{YOUR_WORKSPACE}/functions/{YOUR_MCP_SERVER_NAME}\n```\n\nOr install globally:\n\n```bash\nnpm install -g @blaxel/mcp-gateway\nmcp-gateway --url wss://run.blaxel.ai/{YOUR_WORKSPACE}/functions/{YOUR_MCP_SERVER_NAME}\n```\n\nOr install locally from source:\n\n```bash\ngit clone https://github.com/blaxel-ai/mcp-gateway\ncd mcp-gateway\nnpm install\nnpm run build\nnode dist/index.mjs --url wss://run.blaxel.ai/{YOUR_WORKSPACE}/functions/{YOUR_MCP_SERVER_NAME}\n```\n\n## Configuration\n\nPass the WebSocket URL with the `--url` flag. Example:\n\n```bash\nnpx -y @blaxel/mcp-gateway@latest --url wss://run.blaxel.ai/{YOUR_WORKSPACE}/functions/{YOUR_MCP_SERVER_NAME}\n```\n\n### Authentication\n\nThe gateway uses Blaxel's automatic authentication. Make sure you're authenticated with Blaxel CLI:\n\n```bash\nbl login\n```\n\nOr set environment variables:\n\n```bash\nexport BL_API_KEY=\"your-api-key\"\nexport BL_WORKSPACE=\"your-workspace\"\n```\n\n## Development\n\n```bash\nnpm run build    # Build the TypeScript code\nnpx @modelcontextprotocol/inspector npx -y @blaxel/mcp-gateway@latest --url wss://run.blaxel.ai/{YOUR_WORKSPACE}/functions/{YOUR_MCP_SERVER_NAME} # Debug\n```\n\n### Project Structure\n\n- `index.ts` - Main MCP gateway implementation\n- `package.json` - Dependencies and scripts\n- `tsconfig.json` - TypeScript configuration\n\n## How It Works\n\n1. **Connection**: The gateway connects to a Blaxel MCP server via WebSocket using the provided URL\n2. **Tool Discovery**: It automatically discovers all available tools from the connected MCP server\n3. **Proxy**: It acts as a proxy, forwarding tool calls from the stdio client to the Blaxel MCP server\n4. **Response Handling**: It forwards responses back to the stdio client\n\n## Troubleshooting\n\n### Common Issues\n\n- **Connection Failed**: Verify your WebSocket URL and authentication\n- **No Tools Found**: Ensure your Blaxel MCP server is running and has tools\n- **Authentication Error**: Make sure you're logged in with Blaxel CLI or have valid API keys\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## Contributing\n\n1. Fork the repository\n2. Create your feature branch (`git checkout -b feature/amazing-feature`)\n3. Commit your changes (`git commit -m 'Add some amazing feature'`)\n4. Push to the branch (`git push origin feature/amazing-feature`)\n5. Open a Pull Request\n\n## Support\n\nFor support, please:\n\n- Check the [Blaxel documentation](https://docs.blaxel.ai)\n- Open an issue in the GitHub repository\n- Contact the maintainers\n\n## Acknowledgments\n\n- Model Context Protocol (MCP) community\n- Blaxel team for the MCP hosting infrastructure\n- Cursor team for MCP integration\n","readmeFilename":"README.md"}