{"_id":"@airbodev/mcp-remote-bridge","name":"@airbodev/mcp-remote-bridge","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@airbodev/mcp-remote-bridge","version":"1.0.0","description":"Bridge that connects Claude Desktop to remote MCP servers via HTTP POST","type":"module","bin":{"mcp-remote-bridge":"index.mjs"},"keywords":["mcp","claude","model-context-protocol","bridge","stdio","http"],"author":"","license":"MIT","engines":{"node":">=18.0.0"},"repository":{"type":"git","url":""},"homepage":"","_id":"@airbodev/mcp-remote-bridge@1.0.0","gitHead":"d44d385ef1534684916e7fcdb9922dbbca5c7a8d","_nodeVersion":"22.17.0","_npmVersion":"10.9.2","dist":{"integrity":"sha512-wT3ZYaSj/S4NbiRQ/EP+++CJI9ZjsOigJ5WUsKGyqqY1+viOjzQ78JmpwRWTt+J0M51Csfeqsj+Nt3DINfolmg==","shasum":"6b7e6211bfad5706c308b98ab089378ecf03e6ab","tarball":"https://registry.npmjs.org/@airbodev/mcp-remote-bridge/-/mcp-remote-bridge-1.0.0.tgz","fileCount":3,"unpackedSize":6148,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIFVktzMjRdKFYiATdiOccv9zjUHAcAKdsVALhkucJeo/AiEA7wm5QfJ7IdkF7+Da45C15CyUTqXWjB4BjjBBJ64GOF4="}]},"_npmUser":{"name":"rebecaairbo","email":"rebeca@airbo.com"},"directories":{},"maintainers":[{"name":"rebecaairbo","email":"rebeca@airbo.com"},{"name":"devairbo","email":"dev@airbo.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-remote-bridge_1.0.0_1768323521064_0.7434952696291757"},"_hasShrinkwrap":false}},"time":{"created":"2026-01-13T16:58:40.972Z","1.0.0":"2026-01-13T16:58:41.212Z","modified":"2026-01-13T16:58:41.635Z"},"maintainers":[{"name":"rebecaairbo","email":"rebeca@airbo.com"},{"name":"devairbo","email":"dev@airbo.com"}],"description":"Bridge that connects Claude Desktop to remote MCP servers via HTTP POST","keywords":["mcp","claude","model-context-protocol","bridge","stdio","http"],"repository":{"type":"git","url":""},"license":"MIT","readme":"# @airbodev/mcp-remote-bridge\n\nA lightweight bridge that connects Claude Desktop to remote MCP (Model Context Protocol) servers via HTTP POST.\n\n## Why?\n\nClaude Desktop communicates with MCP servers via **stdio** (standard input/output). If your MCP server is a remote HTTP API, this bridge translates between the two protocols.\n\n```\nClaude Desktop (stdio) ←→ mcp-remote-bridge ←→ Your Server (HTTP POST)\n```\n\n## Installation\n\nNo installation required! Just configure Claude Desktop to use `npx`.\n\n## Configuration\n\nEdit your Claude Desktop config file:\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    \"my-server\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@airbodev/mcp-remote-bridge\"],\n      \"env\": {\n        \"MCP_SERVER_URL\": \"https://your-server.com/mcp\",\n        \"MCP_AUTH_TOKEN\": \"your-token-here\"\n      }\n    }\n  }\n}\n```\n\nThen restart Claude Desktop.\n\n## Environment Variables\n\n| Variable         | Required | Description                                                   |\n| ---------------- | -------- | ------------------------------------------------------------- |\n| `MCP_SERVER_URL` | Yes      | The URL of your MCP server endpoint                           |\n| `MCP_AUTH_TOKEN` | Yes      | Authentication token (sent as `Authorization: Token <token>`) |\n\n## How It Works\n\n1. Claude Desktop starts the bridge as a child process\n2. Claude sends JSON-RPC messages via stdin\n3. The bridge forwards them as HTTP POST requests to your server\n4. Your server responds with JSON-RPC\n5. The bridge sends the response back to Claude via stdout\n\n## Server Requirements\n\nYour MCP server must:\n\n- Accept POST requests with `Content-Type: application/json`\n- Accept `Authorization: Token <token>` header\n- Respond with valid JSON-RPC 2.0 messages\n\n## Troubleshooting\n\n### \"MCP_SERVER_URL is required\"\n\nMake sure you set the `MCP_SERVER_URL` in the `env` section of your config.\n\n### \"MCP_AUTH_TOKEN is required\"\n\nMake sure you set the `MCP_AUTH_TOKEN` in the `env` section of your config.\n\n### Connection errors\n\n1. Verify your server URL is correct and accessible\n2. Check if your token is valid\n3. Ensure your server is running\n4. Try restarting Claude Desktop\n\n## Requirements\n\n- Node.js 18 or higher\n\n## License\n\nMIT\n","readmeFilename":"README.md","_rev":"1-cedcb430d5f8fb38b56dbb14e433f8d4"}