{"_id":"redis-switchboard-mcp","_rev":"10-bb4f7130291b5807b3734a18e0e258ca","name":"redis-switchboard-mcp","dist-tags":{"latest":"0.1.6"},"versions":{"0.0.0-stage":{"name":"redis-switchboard-mcp","version":"0.0.0-stage","_id":"redis-switchboard-mcp@0.0.0-stage","stub":true,"maintainers":[{"name":"hexiaowu","email":"hexiaowu1993@gmail.com"}],"dist":{"shasum":"136bd7df01c8ae755bd5df7050a044fdfebf6e5d","tarball":"https://registry.npmjs.org/redis-switchboard-mcp/-/redis-switchboard-mcp-0.0.0-stage.tgz","fileCount":2,"integrity":"sha512-Dwins/rztGb0yhdqc+YR4rofZvuXkQFeJndsh442jJBzoK4B1Hw9uB9PtOrypxwnzokzQfXV2KfuELYZzNa4iA==","signatures":[{"sig":"MEUCIQCChfn7iky/n99P3FgTY6hGN1bfRv0t8D9LQhA/qh2R4QIgVwtFSGOImM2VDdUEaQiEYOzsh3o1mf+lGxuQOPQ+jiY=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":343},"_npmUser":{"name":"hexiaowu","email":"hexiaowu1993@gmail.com"},"deprecated":"Placeholder; use 0.1.1.","description":"Temporary package placeholder for staged publishing","directories":{}},"0.1.0":{"name":"redis-switchboard-mcp","version":"0.1.0","keywords":["mcp","model-context-protocol","redis","database","ai","llm"],"author":{"name":"hexiaowu"},"license":"MIT","_id":"redis-switchboard-mcp@0.1.0","maintainers":[{"name":"hexiaowu","email":"hexiaowu1993@gmail.com"}],"homepage":"https://github.com/hexiaowu/redis-switchboard-mcp#readme","bugs":{"url":"https://github.com/hexiaowu/redis-switchboard-mcp/issues"},"bin":{"rsm":"dist/index.js"},"dist":{"shasum":"e4a7acba1c183b46e098c793e5be895fb7760256","tarball":"https://registry.npmjs.org/redis-switchboard-mcp/-/redis-switchboard-mcp-0.1.0.tgz","fileCount":64,"integrity":"sha512-Hex8R0oz9wvWRtfC+ZwEG89Ov3o4kDb4GEhK4uKUvoi2ixFC2aclV9UqJ1blUpT/BGf4rC0+NyBHi9t/7BIiaQ==","signatures":[{"sig":"MEQCIBGwx8zcv+o3eaHbOy7jawIdWiX0aepnMHS+dalGRB30AiAs0nc6uFrY+kiVdkoFEsDFiHSEBEt8eaYTs+XSFUzp0w==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIQCnyVYK7VCUoW0mVVstyhEDaeWnXM119vmJBE+sTNnH9AIgIhTjcccdlINRLI0vTlJbkJVAI8UzKx2FcxLWLQzoCe8=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":310655},"main":"dist/lib.js","type":"module","types":"dist/lib.d.ts","engines":{"node":">=20"},"exports":{".":{"types":"./dist/lib.d.ts","default":"./dist/lib.js"}},"gitHead":"769fb3619fe887c2d7c8c7b13e3afb6ca76a17ab","scripts":{"dev":"tsx src/index.ts","test":"node --import tsx --test test/*.test.ts","build":"tsc -p tsconfig.json","check":"npm run typecheck && npm run typecheck:test && npm test","start":"node dist/index.js","typecheck":"tsc -p tsconfig.json --noEmit","prepublishOnly":"npm run typecheck && npm run typecheck:test && npm run build && npm test","typecheck:test":"tsc -p tsconfig.test.json"},"_npmUser":{"name":"hexiaowu","email":"hexiaowu1993@gmail.com"},"deprecated":"Documentation fix in 0.1.1; please use 0.1.1.","repository":{"url":"git+https://github.com/hexiaowu/redis-switchboard-mcp.git","type":"git"},"_npmVersion":"10.8.2","description":"A Redis MCP server that switches logical databases per request instead of relying on the connection-level SELECT command.","directories":{},"_nodeVersion":"20.19.2","dependencies":{"zod":"^4.6.7","ioredis":"^5.11.1","@modelcontextprotocol/sdk":"^1.32.2"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.23.15","typescript":"^5.9.0","@types/node":"^20.19.0"},"_npmOperationalInternal":{"tmp":"tmp/redis-switchboard-mcp_0.1.0_1793715649163_0.3258753063192463","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"redis-switchboard-mcp","version":"0.1.1","keywords":["mcp","model-context-protocol","redis","database","ai","llm"],"author":{"name":"hexiaowu"},"license":"MIT","_id":"redis-switchboard-mcp@0.1.1","maintainers":[{"name":"hexiaowu","email":"hexiaowu1993@gmail.com"}],"homepage":"https://github.com/hexiaowu/redis-switchboard-mcp#readme","bugs":{"url":"https://github.com/hexiaowu/redis-switchboard-mcp/issues"},"bin":{"rsm":"dist/index.js"},"dist":{"shasum":"04af234b00940185d9d5558f316890bfe3cac412","tarball":"https://registry.npmjs.org/redis-switchboard-mcp/-/redis-switchboard-mcp-0.1.1.tgz","fileCount":64,"integrity":"sha512-aOdEkQZR7DR9pp2GwqLYzINwJogDYlGyaSYSiHamLZPTUQLMKR49faPr5/yjIksi4qmcGmxXYo2FypED9Udafw==","signatures":[{"sig":"MEQCID5a1X7xDeISmaw39oVvhu1vNnH3Oq8vA9675OXGMfEIAiBTcZyMMOEdKzcQGd0zGWONpkE1WVrWhyfF2TcPkui/uQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIASmr7dWs8DiGBcYCRVawGbKBOivxR8Z6/cA0uVzne/8AiEA3XJsvghmjzlLSqNMka5iVTsPNrWO+y/Rzm+uJG8/cT8=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":310502},"main":"dist/lib.js","type":"module","types":"dist/lib.d.ts","engines":{"node":">=20"},"exports":{".":{"types":"./dist/lib.d.ts","default":"./dist/lib.js"}},"gitHead":"ee767a3880cce84bc1ab605f2479e966916ed847","scripts":{"dev":"tsx src/index.ts","test":"node --import tsx --test test/*.test.ts","build":"tsc -p tsconfig.json","check":"npm run typecheck && npm run typecheck:test && npm test","start":"node dist/index.js","typecheck":"tsc -p tsconfig.json --noEmit","prepublishOnly":"npm run typecheck && npm run typecheck:test && npm run build && npm test","typecheck:test":"tsc -p tsconfig.test.json"},"_npmUser":{"name":"hexiaowu","email":"hexiaowu1993@gmail.com"},"repository":{"url":"git+https://github.com/hexiaowu/redis-switchboard-mcp.git","type":"git"},"_npmVersion":"10.8.2","description":"A Redis MCP server that switches logical databases per request instead of relying on the connection-level SELECT command.","directories":{},"_nodeVersion":"20.19.2","dependencies":{"zod":"^4.6.7","ioredis":"^5.11.1","@modelcontextprotocol/sdk":"^1.32.2"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.23.15","typescript":"^5.9.0","@types/node":"^20.19.0"},"_npmOperationalInternal":{"tmp":"tmp/redis-switchboard-mcp_0.1.1_1793716536084_0.7317830408932849","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"redis-switchboard-mcp","version":"0.1.2","keywords":["mcp","model-context-protocol","redis","database","ai","llm"],"author":{"name":"hexiaowu"},"license":"MIT","_id":"redis-switchboard-mcp@0.1.2","maintainers":[{"name":"hexiaowu","email":"hexiaowu1993@gmail.com"}],"homepage":"https://github.com/hexiaowu/redis-switchboard-mcp#readme","bugs":{"url":"https://github.com/hexiaowu/redis-switchboard-mcp/issues"},"bin":{"rsm":"dist/index.js","redis-switchboard-mcp":"dist/index.js"},"dist":{"shasum":"cd13bbb3ef9de543de6a7b5390f463d0be503b57","tarball":"https://registry.npmjs.org/redis-switchboard-mcp/-/redis-switchboard-mcp-0.1.2.tgz","fileCount":64,"integrity":"sha512-JtPzgGlvGM2CQ7IUxtv5V1uuJxsjAi1pwpVYm1BLs2zziaVf+vicrhwRn7PTvpNgPQypiCUHvDkmD9GS45+u5Q==","signatures":[{"sig":"MEQCIHmt2xjEViUvOdmMpuxuZbaOZ4LCpjboJQUnjX8df7znAiBY4OZoZvWlJqTFthHsqwFUvdc8cbUeJHLXZiG/PowRaw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEYCIQCSpTw6WDyxK4QAH5WNACQNchn7TECiFsuAcco/nmPFjwIhAPh9LTMIqiJiz8F+a32S6y6dhMiMBfcw2WJy2wVHtLe5","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":315957},"main":"dist/lib.js","type":"module","types":"dist/lib.d.ts","engines":{"node":">=20"},"exports":{".":{"types":"./dist/lib.d.ts","default":"./dist/lib.js"}},"gitHead":"57bc8ea2a79ad45f2b4d46e2b960b24b70958fc4","scripts":{"dev":"tsx src/index.ts","test":"node --import tsx --test test/*.test.ts","build":"tsc -p tsconfig.json","check":"npm run typecheck && npm run typecheck:test && npm test","start":"node dist/index.js","typecheck":"tsc -p tsconfig.json --noEmit","prepublishOnly":"npm run typecheck && npm run typecheck:test && npm run build && npm test","typecheck:test":"tsc -p tsconfig.test.json"},"_npmUser":{"name":"hexiaowu","email":"hexiaowu1993@gmail.com"},"repository":{"url":"git+https://github.com/hexiaowu/redis-switchboard-mcp.git","type":"git"},"_npmVersion":"10.8.2","description":"A Redis MCP server that switches logical databases per request instead of relying on the connection-level SELECT command.","directories":{},"_nodeVersion":"20.19.2","dependencies":{"zod":"^4.6.7","ioredis":"^5.11.1","@modelcontextprotocol/sdk":"^1.32.2"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.23.15","typescript":"^5.9.0","@types/node":"^20.19.0"},"_npmOperationalInternal":{"tmp":"tmp/redis-switchboard-mcp_0.1.2_1793720062792_0.3242113454255222","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"redis-switchboard-mcp","version":"0.1.3","keywords":["mcp","model-context-protocol","redis","database","ai","llm"],"author":{"name":"hexiaowu"},"license":"MIT","_id":"redis-switchboard-mcp@0.1.3","maintainers":[{"name":"hexiaowu","email":"hexiaowu1993@gmail.com"}],"homepage":"https://github.com/hexiaowu/redis-switchboard-mcp#readme","bugs":{"url":"https://github.com/hexiaowu/redis-switchboard-mcp/issues"},"bin":{"rsm":"dist/index.js","redis-switchboard-mcp":"dist/index.js"},"dist":{"shasum":"0f4a8bb2195c21f6745d05b225494ec9074f2c34","tarball":"https://registry.npmjs.org/redis-switchboard-mcp/-/redis-switchboard-mcp-0.1.3.tgz","fileCount":64,"integrity":"sha512-FL1Eqi6mgwIo29qkbYZYGbz5bHq52cYeX+d2XCz8FolpSVlIdQ1nHwumy6n1e5V+Or+7rTOBCLvRsd4nTXww/Q==","signatures":[{"sig":"MEUCIGqZYvpd8CXlwifzaOy214YDRZDnfR1pEc/ZSz18Sqy+AiEA73LmUgXhxf5mckr2p3nfXt9K7uQWvFAIJcmByOnpegs=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEQCIBuQ895u/7D+lT9gTr1TyTkIM487I1SHjr3ZK3XicaA1AiBYJ8QoOpGfGj4IlJYjDG68w7oyk+h53vULgcivRvviSA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":317316},"main":"dist/lib.js","type":"module","types":"dist/lib.d.ts","engines":{"node":">=20"},"exports":{".":{"types":"./dist/lib.d.ts","default":"./dist/lib.js"}},"gitHead":"dbd2f0f2d3e1621d267a33726f667e2ce4928fbc","scripts":{"dev":"tsx src/index.ts","test":"node --import tsx --test test/*.test.ts","build":"tsc -p tsconfig.json","check":"npm run typecheck && npm run typecheck:test && npm test","start":"node dist/index.js","typecheck":"tsc -p tsconfig.json --noEmit","prepublishOnly":"npm run typecheck && npm run typecheck:test && npm run build && npm test","typecheck:test":"tsc -p tsconfig.test.json"},"_npmUser":{"name":"hexiaowu","email":"hexiaowu1993@gmail.com"},"repository":{"url":"git+https://github.com/hexiaowu/redis-switchboard-mcp.git","type":"git"},"_npmVersion":"10.8.2","description":"A Redis MCP server that switches logical databases per request instead of relying on the connection-level SELECT command.","directories":{},"_nodeVersion":"20.19.2","dependencies":{"zod":"^4.6.7","ioredis":"^5.11.1","@modelcontextprotocol/sdk":"^1.32.2"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.23.15","typescript":"^5.9.0","@types/node":"^20.19.0"},"_npmOperationalInternal":{"tmp":"tmp/redis-switchboard-mcp_0.1.3_1793721571073_0.7514780093566179","host":"s3://npm-registry-packages-npm-production"}},"0.1.4":{"name":"redis-switchboard-mcp","version":"0.1.4","keywords":["mcp","model-context-protocol","redis","database","ai","llm"],"author":{"name":"hexiaowu"},"license":"MIT","_id":"redis-switchboard-mcp@0.1.4","maintainers":[{"name":"hexiaowu","email":"hexiaowu1993@gmail.com"}],"homepage":"https://github.com/hexiaowu/redis-switchboard-mcp#readme","bugs":{"url":"https://github.com/hexiaowu/redis-switchboard-mcp/issues"},"bin":{"rsm":"dist/index.js","redis-switchboard-mcp":"dist/index.js"},"dist":{"shasum":"884005869892ab29bd7501148c0c6fdfc65906fa","tarball":"https://registry.npmjs.org/redis-switchboard-mcp/-/redis-switchboard-mcp-0.1.4.tgz","fileCount":64,"integrity":"sha512-VzViehCdiGNTTK6KzXvWP84EvW29XAAS1BM0XmCS6rji7FA1ST/UHn0G3tetKOhvsrYIose+9PUHWsOL0f7hSw==","signatures":[{"sig":"MEUCIQDfGXL66FK9/YfjQyEOiLVYcsahZt5qypIr3Eo6pvc7OQIgC8DJgXEqQnlIna9/h+/8eXN/lgdeGFgs1w7un5kO35o=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIQC7aQ9tC1NZE2x4bDDdjUeRwff4ym4yivSF7VXjhdReiQIge+zBTwRIZxD1XXiCEmDol3yesm7y43So3dxQeCyTy2o=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/redis-switchboard-mcp@0.1.4","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":317316},"main":"dist/lib.js","type":"module","types":"dist/lib.d.ts","engines":{"node":">=20"},"exports":{".":{"types":"./dist/lib.d.ts","default":"./dist/lib.js"}},"gitHead":"2ba0ba6718f7e0c49b409117079a9a4454d62e0a","scripts":{"dev":"tsx src/index.ts","test":"node --import tsx --test test/*.test.ts","build":"tsc -p tsconfig.json","check":"npm run typecheck && npm run typecheck:test && npm test","start":"node dist/index.js","typecheck":"tsc -p tsconfig.json --noEmit","prepublishOnly":"npm run typecheck && npm run typecheck:test && npm run build && npm test","typecheck:test":"tsc -p tsconfig.test.json"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"c3d77e35-0cb2-452a-9513-0ec02fe541af"}},"repository":{"url":"git+https://github.com/hexiaowu/redis-switchboard-mcp.git","type":"git"},"_npmVersion":"11.21.1","description":"A Redis MCP server that switches logical databases per request instead of relying on the connection-level SELECT command.","directories":{},"_nodeVersion":"22.14.0","dependencies":{"zod":"^4.6.7","ioredis":"^5.11.1","@modelcontextprotocol/sdk":"^1.32.2"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.23.15","typescript":"^5.9.0","@types/node":"^20.19.0"},"_npmOperationalInternal":{"tmp":"tmp/redis-switchboard-mcp_0.1.4_1793722804397_0.2790940183189009","host":"s3://npm-registry-packages-npm-production"}},"0.1.5":{"name":"redis-switchboard-mcp","version":"0.1.5","keywords":["mcp","model-context-protocol","redis","database","ai","llm"],"author":{"name":"hexiaowu"},"license":"MIT","_id":"redis-switchboard-mcp@0.1.5","maintainers":[{"name":"hexiaowu","email":"hexiaowu1993@gmail.com"}],"homepage":"https://github.com/hexiaowu/redis-switchboard-mcp#readme","bugs":{"url":"https://github.com/hexiaowu/redis-switchboard-mcp/issues"},"bin":{"rsm":"dist/index.js","redis-switchboard-mcp":"dist/index.js"},"dist":{"shasum":"773ddd25203a33f9db66b29f1e1c50346410909b","tarball":"https://registry.npmjs.org/redis-switchboard-mcp/-/redis-switchboard-mcp-0.1.5.tgz","fileCount":64,"integrity":"sha512-QocL41ovrSrA6Q5492IGR0WSZONbiq87fFTm4/i75mNpqrUxN+bT1Ge3knperebwqE5bZCf4kyRd9GhVseMg1A==","signatures":[{"sig":"MEUCIG17r5IxMJYxfd/Oh9lQZGVeKbOdiYw/r+jn4yqFz8AOAiEAvAMQ0Jw2AzEJXJu2/Kve99kiQSzGkTGqTLzPg/hrjZc=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIQCiPam5yxVoG+OiUtw9tv3kkiyaZJ+GSnmPXF4p1891UQIgdePqy0RjX7W2EGvztqCwmIgxMlCFcLhSIP+rP1R0UWU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":372052},"main":"dist/lib.js","type":"module","types":"dist/lib.d.ts","engines":{"node":">=20"},"exports":{".":{"types":"./dist/lib.d.ts","default":"./dist/lib.js"}},"gitHead":"5d6f95ccaff146ca43beba179eddfc6401a68a56","scripts":{"dev":"tsx src/index.ts","test":"node --import tsx --test test/commands.test.ts test/config.test.ts test/connection-lifecycle.test.ts test/errors.test.ts test/fetch-guard.test.ts test/integration.test.ts test/mcp.test.ts test/read-page.test.ts test/redis-manager.test.ts test/tools.test.ts test/truncate.test.ts","build":"tsc -p tsconfig.json","check":"npm run typecheck && npm run typecheck:test && npm test","start":"node dist/index.js","typecheck":"tsc -p tsconfig.json --noEmit","prepublishOnly":"npm run typecheck && npm run typecheck:test && npm run build && npm test","typecheck:test":"tsc -p tsconfig.test.json"},"_npmUser":{"name":"hexiaowu","email":"hexiaowu1993@gmail.com"},"repository":{"url":"git+https://github.com/hexiaowu/redis-switchboard-mcp.git","type":"git"},"_npmVersion":"10.8.2","description":"A Redis MCP server that switches logical databases per request instead of relying on the connection-level SELECT command.","directories":{},"_nodeVersion":"20.19.2","dependencies":{"zod":"^4.6.7","ioredis":"^5.11.1","@modelcontextprotocol/sdk":"^1.32.2"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.23.15","typescript":"^5.9.0","@types/node":"^20.19.0"},"_npmOperationalInternal":{"tmp":"tmp/redis-switchboard-mcp_0.1.5_1793726897740_0.2562738191272469","host":"s3://npm-registry-packages-npm-production"}},"0.1.6":{"_id":"redis-switchboard-mcp@0.1.6","bin":{"rsm":"dist/index.js","redis-switchboard-mcp":"dist/index.js"},"bugs":{"url":"https://github.com/hexiaowu/redis-switchboard-mcp/issues"},"dist":{"shasum":"24352429c21f696f9f1735dd195ddc8a18c4ed49","tarball":"https://registry.npmjs.org/redis-switchboard-mcp/-/redis-switchboard-mcp-0.1.6.tgz","fileCount":63,"integrity":"sha512-uEiCj108ETSiYsc03HatCy0bYDkFQWiCdy2mfNZuWJmsExg+EBzgqB4gVZD2mxgvumwKJhN5T10ZawDIrE19tA==","signatures":[{"sig":"MEUCIQC0tWl90L+6kbjnGjP41ZRgGWJc8g/IIhwz+LiKZwoShwIgJ531Z0+IAyrZgfFH1z03PMB90eIgUinQ9Q3esHRhSd4=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQDLeXCK7NyQFsy8uozqqtt5ac8Io1zUaOlgzkT0n1ZoWgIhAN1NscNiVCE+qHmhmhLiu7krtagm7uvLjsPxQ4M4RE1J"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/redis-switchboard-mcp@0.1.6","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":333808},"main":"dist/lib.js","name":"redis-switchboard-mcp","type":"module","types":"dist/lib.d.ts","author":{"name":"hexiaowu"},"engines":{"node":">=20"},"exports":{".":{"types":"./dist/lib.d.ts","default":"./dist/lib.js"}},"gitHead":"723a5fd22bca69aad2dfa65bf5b445b6c027097c","license":"MIT","scripts":{"dev":"tsx src/index.ts","test":"node --import tsx --test test/commands.test.ts test/config.test.ts test/connection-lifecycle.test.ts test/errors.test.ts test/fetch-guard.test.ts test/integration.test.ts test/mcp.test.ts test/read-page.test.ts test/redis-manager.test.ts test/tools.test.ts test/truncate.test.ts","build":"tsc -p tsconfig.json","check":"npm run typecheck && npm run typecheck:test && npm test","start":"node dist/index.js","typecheck":"tsc -p tsconfig.json --noEmit","prepublishOnly":"npm run typecheck && npm run typecheck:test && npm run build && npm test","typecheck:test":"tsc -p tsconfig.test.json"},"version":"0.1.6","_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"c3d77e35-0cb2-452a-9513-0ec02fe541af"}},"homepage":"https://github.com/hexiaowu/redis-switchboard-mcp#readme","keywords":["mcp","model-context-protocol","redis","database","ai","llm"],"repository":{"url":"git+https://github.com/hexiaowu/redis-switchboard-mcp.git","type":"git"},"_npmVersion":"11.21.2","description":"A Redis MCP server that switches logical databases per request instead of relying on the connection-level SELECT command.","directories":{},"maintainers":[{"name":"hexiaowu","email":"hexiaowu1993@gmail.com"}],"_nodeVersion":"22.14.0","dependencies":{"zod":"^4.6.7","ioredis":"^5.11.1","@modelcontextprotocol/sdk":"^1.32.2"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.23.15","typescript":"^5.9.0","@types/node":"^20.19.0"},"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/redis-switchboard-mcp_0.1.6_1794411568303_0.4616101318096206"}}},"time":{"created":"2026-11-03T14:19:10.860Z","modified":"2026-11-11T15:39:29.238Z","0.0.0-stage":"2026-11-03T14:19:10.860Z","0.1.0":"2026-11-03T14:20:49.367Z","0.1.1":"2026-11-03T14:35:36.181Z","0.1.2":"2026-11-03T15:34:22.948Z","0.1.3":"2026-11-03T15:59:31.179Z","0.1.4":"2026-11-03T16:20:04.513Z","0.1.5":"2026-11-03T17:28:17.876Z","0.1.6":"2026-11-11T15:39:28.405Z"},"bugs":{"url":"https://github.com/hexiaowu/redis-switchboard-mcp/issues"},"author":{"name":"hexiaowu"},"license":"MIT","homepage":"https://github.com/hexiaowu/redis-switchboard-mcp#readme","keywords":["mcp","model-context-protocol","redis","database","ai","llm"],"repository":{"url":"git+https://github.com/hexiaowu/redis-switchboard-mcp.git","type":"git"},"description":"A Redis MCP server that switches logical databases per request instead of relying on the connection-level SELECT command.","maintainers":[{"name":"hexiaowu","email":"hexiaowu1993@gmail.com"}],"readme":"# redis-switchboard-mcp\n\n[English](https://github.com/hexiaowu/redis-switchboard-mcp/blob/main/README.md) | [简体中文](https://github.com/hexiaowu/redis-switchboard-mcp/blob/main/docs/zh-CN.md)\n\nA Redis MCP server that switches **logical databases per request** instead of relying on Redis's connection-level `SELECT`.\n\n```text\nexecute    → run a Redis command against db 2, db 4, ...\nread_page  → bounded page of a list / hash / set / zset / stream / string\nscan_keys  → cursor-based SCAN with limits\nkey_info   → type / TTL / memory / encoding / length\n```\n\n`redis-switchboard-mcp` is designed for the way MCP clients actually work: many independent tool calls, often concurrent, against several environments and several Redis logical databases.\n\nTool parameters and descriptions are delivered to the MCP client through `tools/list`; this README covers configuration, safety limits and runtime behavior.\n\n## Quick start\n\n1. Check you are on Node.js 20+ — no global install is needed, the client launches `npx -y redis-switchboard-mcp`.\n2. Add the server to your MCP client: [MCP client configuration](#mcp-client-configuration).\n3. Restart the client and run `PING`; a working setup returns `PONG`.\n\n---\n\n## Why this exists\n\nRedis's `SELECT` changes the database of a **connection**, not of a command. An MCP server that shares one connection and runs `SELECT` on demand will silently mix databases: a concurrent call, a pooled connection, or an automatic reconnect can leave the client on the wrong DB.\n\nThis server treats the database as a per-call argument instead. Every tool accepts `db`, each `(instance, db)` gets its own connection selected and verified for that database, and `SELECT` (plus `MOVE`, `SWAPDB`, `COPY ... DB`) is rejected. So `execute` in db 2 and db 4 can run concurrently without leaking state, and a reconnect never lands a command on the wrong database.\n\n---\n\n## Features\n\n- **Per-call database selection** for every tool (`db: 0-255`).\n- **Multiple Redis instances** from a JSON config, selected with the `instance` argument.\n- **Explicit permission mode** (`readonly` / `readwrite`, default `readonly`); `readonly` uses an explicit read-command whitelist.\n- **Command blocklist** for connection-level, administrative, destructive and blocking commands.\n- **Lua scripting disabled by default** (`EVAL`/`EVALSHA`/`FCALL`).\n- **Bounded output** with per-container and global item/character budgets.\n- **Paged collection reads** via `read_page`, so large lists/hashes/sets/streams are never fetched in one shot.\n- **Fetch guards** in `execute`: unbounded bulk reads are rejected before they materialize, with a pointer to `read_page` (see [Output and fetch bounds](#output-and-fetch-bounds)).\n- **Bounded scans** with `limit`, SCAN iteration cap, and a wall-clock budget.\n- **Cluster detection** — logical DBs other than 0 are rejected on a Redis Cluster.\n- **Connection cache limit** per instance (`maxConnections`, default 32), with a small pool per `(instance, db)` (`poolSize`, default 4) and **idle connection recycling** (`idleTimeoutMs`, default 5 minutes): a connection that has not run any command for 5 minutes is closed and evicted, so databases you stop using stop holding server resources.\n- **Credential redaction** in error messages.\n- **No stdout logging** — stdout is reserved for the MCP stdio transport.\n\n---\n\n## Requirements\n\n- Node.js **20 or newer**\n- Redis 6 or newer (`SCAN TYPE`); `SORT_RO` requires Redis 7+\n- A standalone Redis server, or a Redis Cluster used at **db 0 only**\n\n---\n\n## Installation\n\n### From npm\n\n```bash\nnpm install -g redis-switchboard-mcp\nrsm --help\n```\n\nOr run it without a global install:\n\n```bash\nnpx -y redis-switchboard-mcp\n```\n\n### From source\n\n```bash\ngit clone https://github.com/hexiaowu/redis-switchboard-mcp.git\ncd redis-switchboard-mcp\nnpm ci\nnpm run build\nnode dist/index.js\n```\n\n---\n\n## MCP client configuration\n\nAdd the block below to your MCP client's server configuration — for example `claude_desktop_config.json` for Claude Desktop. Other clients (VS Code, for instance) use different files or keys; the `mcpServers` shape shown here is the common one.\n\n### Single instance, environment variables\n\nUse this if you have one Redis; see [multiple instances](#multiple-instances-from-a-json-file) only if you need several.\n\n```json\n{\n  \"mcpServers\": {\n    \"redis\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"redis-switchboard-mcp\"],\n      \"env\": {\n        \"REDIS_HOST\": \"127.0.0.1\",\n        \"REDIS_PORT\": \"6379\",\n        \"REDIS_PASSWORD\": \"your-password\",\n        \"REDIS_MODE\": \"readonly\"\n      }\n    }\n  }\n}\n```\n\nRemove `REDIS_PASSWORD` if your Redis requires no authentication.\n\nIf the package is installed globally, `\"command\": \"rsm\"` with no `args` also works.\n\n### Multiple instances from a JSON file\n\n```json\n{\n  \"mcpServers\": {\n    \"redis\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"redis-switchboard-mcp\"],\n      \"env\": {\n        \"REDIS_MCP_CONFIG\": \"/Users/me/.config/redis-switchboard.config.json\"\n      }\n    }\n  }\n}\n```\n\n> **Note:** diagnostics are written to stderr; stdout is reserved for the MCP stdio transport.\n\n### Verify the setup\n\nRestart the MCP client, then ask it to run a command:\n\n```json\n{ \"command\": \"PING\", \"db\": 0 }\n```\n\nA working setup returns `\"reply\": \"PONG\"`. Use the `db` argument to target another logical database; it defaults to the instance `db`. Then ask it for real work, for example “run `GET user:42` against db 2”.\n\n---\n\n<h2 align=\"center\">⚙️ Configuration</h2>\n\n<h3 align=\"center\">🔀 Precedence</h3>\n\n1. Command-line flags (`--config`, `--db`, ...)\n2. Environment variables\n3. Defaults\n\n`--config` selects a JSON config file. `--name`/`--db` are rejected when a JSON config is used; edit the JSON file for per-instance values.\n\n<h3 align=\"center\">🎛️ Command-line options</h3>\n\n<p align=\"center\"><strong>Legend:</strong> ✅ Required · 🔶 Conditionally required · ⚪ Optional</p>\n\n| Option | Required | Description |\n| :---: | :---: | :---: |\n| `--config <path>` | 🔶 Conditional | JSON config file describing one or more Redis instances |\n| `--name <name>` | ⚪ Optional | Instance name (default: `default`) |\n| `--db <n>` | ⚪ Optional | Default logical database, 0-255 (default: 0) |\n| `--mode <mode>` | ⚪ Optional | Override permission mode for all instances: `readonly` or `readwrite` |\n| `-h`, `--help` | ⚪ Optional | Show help |\n| `-v`, `--version` | ⚪ Optional | Show the version |\n\n\n<h3 align=\"center\">🌱 Environment variables (single instance)</h3>\n\n<p align=\"center\"><strong>Legend:</strong> ✅ Required · 🔶 Conditionally required · ⚪ Optional</p>\n\n| Variable | Required | Default | Description |\n| :---: | :---: | :---: | :---: |\n| `REDIS_MCP_CONFIG` | 🔶 Conditional | — | Path to a multi-instance JSON config file |\n| `REDIS_NAME` | ⚪ Optional | `default` | Instance name for the single-instance form |\n| `REDIS_HOST` | 🔶 Conditional | — | Redis host (required when no JSON config is used) |\n| `REDIS_PORT` | 🔶 Conditional | — | Redis port (required when no JSON config is used) |\n| `REDIS_USERNAME` | ⚪ Optional | — | ACL username |\n| `REDIS_PASSWORD` | 🔶 Conditional | — | Password (required when Redis requires authentication) |\n| `REDIS_DB` | ⚪ Optional | `0` | Default logical database when `db` is omitted |\n| `REDIS_TLS` | ⚪ Optional | `false` | Enable TLS |\n| `REDIS_TLS_REJECT_UNAUTHORIZED` | ⚪ Optional | `true` | Verify the server certificate |\n| `REDIS_MODE` | ⚪ Optional | `readonly` | Permission mode: `readonly` or `readwrite` (defaults to `readonly` when omitted) |\n| `REDIS_ALLOWED_DBS` | ⚪ Optional | — | Comma-separated allowlist, e.g. `0,2,4`; must include `REDIS_DB` |\n| `REDIS_ALLOW_SCRIPTING` | ⚪ Optional | `false` | Allow `EVAL`/`EVALSHA`/`FCALL` (see security caveat) |\n| `REDIS_MAX_CONNECTIONS` | ⚪ Optional | `32` | Per-instance connection cache limit (1-256) |\n| `REDIS_POOL_SIZE` | ⚪ Optional | `4` | Connections pooled per `(instance, db)` (1-16) |\n| `REDIS_IDLE_TIMEOUT_MS` | ⚪ Optional | `300000` | Close an idle `(instance, db)` connection after this long without a command; `0` disables |\n| `REDIS_CONNECT_TIMEOUT_MS` | ⚪ Optional | `5000` | TCP/connect timeout |\n| `REDIS_COMMAND_TIMEOUT_MS` | ⚪ Optional | `15000` | Per-command timeout; `0` disables it (a 60 s socket timeout still applies) |\n| `REDIS_MAX_RESULT_ITEMS` | ⚪ Optional | `200` | Per-array/object item cap in replies |\n| `REDIS_MAX_RESULT_CHARS` | ⚪ Optional | `4000` | Per-string cap in replies |\n| `REDIS_MAX_RESULT_DEPTH` | ⚪ Optional | `4` | Maximum nested container depth |\n| `REDIS_MAX_FETCH_ITEMS` | ⚪ Optional | `1000` | Max items one `execute` bulk read may fetch |\n| `REDIS_MAX_FETCH_CHARS` | ⚪ Optional | `1000000` | Max bytes one `execute` string read may fetch |\n| `REDIS_SCAN_COUNT` | ⚪ Optional | `500` | Default SCAN `COUNT` hint |\n| `REDIS_MAX_SCAN_ITERATIONS` | ⚪ Optional | `200` | Maximum SCAN round trips per call |\n| `REDIS_SCAN_TIME_BUDGET_MS` | ⚪ Optional | `10000` | Wall-clock budget per `scan_keys` call |\n\n<p align=\"center\"><strong>Connection methods:</strong> exactly one of the following.</p>\n\n| Method | Required | How |\n| :---: | :---: | :---: |\n| JSON config | 🔶 Conditional | Set `REDIS_MCP_CONFIG` (or `--config`); host, port and mode come from the file |\n| Host + port | 🔶 Conditional | Set `REDIS_HOST` and `REDIS_PORT` (and `REDIS_MODE` if needed) |\n\nFor the single-instance environment form, `REDIS_HOST` and `REDIS_PORT` are required — there is no built-in host or port default. The JSON config alternative defines `host`/`port` for each instance.\n\nJSON config and `REDIS_HOST`/`REDIS_PORT`/`REDIS_MODE` are **mutually exclusive**: setting them with a JSON config is a configuration error (the process refuses to start and tells you to define host/port/mode per instance in the JSON file). Other single-instance environment variables are not applied when a JSON config is used.\n\n<h3 align=\"center\">🗂️ Multi-instance JSON</h3>\n\n```json\n{\n  \"defaultInstance\": \"cache-dev\",\n  \"instances\": [\n    {\n      \"name\": \"cache-dev\",\n      \"host\": \"127.0.0.1\",\n      \"port\": 6379,\n      \"db\": 0,\n      \"mode\": \"readwrite\",\n      \"allowedDbs\": [0, 2, 4],\n      \"maxConnections\": 32\n    },\n    {\n      \"name\": \"cache-prod\",\n      \"host\": \"redis.prod.internal\",\n      \"port\": 6380,\n      \"username\": \"app\",\n      \"password\": \"your-password\",\n      \"tls\": true,\n      \"db\": 0,\n      \"mode\": \"readonly\",\n      \"allowedDbs\": [0],\n      \"commandTimeoutMs\": 10000,\n      \"maxResultItems\": 100,\n      \"maxResultChars\": 2000,\n      \"maxFetchItems\": 500,\n      \"maxFetchChars\": 500000\n    }\n  ]\n}\n```\n\n<p align=\"center\"><strong>Top-level fields</strong></p>\n\n<p align=\"center\"><strong>Legend:</strong> ✅ Required · 🔶 Conditionally required · ⚪ Optional</p>\n\n| Field | Required | Default | Description |\n| :---: | :---: | :---: | :---: |\n| `instances` | ✅ Required | — | Array with at least one instance |\n| `defaultInstance` | ⚪ Optional | — | Instance used when a tool call omits `instance` |\n\n<p align=\"center\"><strong>Instance fields</strong></p>\n\n<p align=\"center\"><strong>Legend:</strong> ✅ Required · 🔶 Conditionally required · ⚪ Optional</p>\n\n| Field | Required | Default | Description |\n| :---: | :---: | :---: | :---: |\n| `name` | 🔶 Conditional | `default` | Unique instance name; must be unique when several instances are configured |\n| `host` / `port` | ✅ Required | — | Connection endpoint |\n| `username` | ⚪ Optional | — | ACL username |\n| `password` | 🔶 Conditional | — | Inline password (required when Redis requires authentication) |\n| `usernameEnv` / `passwordEnv` | ⚪ Optional | — | Read credentials from an environment variable |\n| `db` | ⚪ Optional | `0` | Default logical database |\n| `tls` | ⚪ Optional | `false` | Enable TLS |\n| `tlsRejectUnauthorized` | ⚪ Optional | `true` | Verify the server certificate |\n| `mode` | ⚪ Optional | `readonly` | Permission mode: `readonly` or `readwrite` (defaults to `readonly` when omitted) |\n| `allowScripting` | ⚪ Optional | `false` | Allow `EVAL`/`EVALSHA`/`FCALL` |\n| `allowedDbs` | ⚪ Optional | — | Restrict which logical DBs this instance may access; must include `db` |\n| `maxConnections` | ⚪ Optional | `32` | Cache limit for `(instance, db)` connections |\n| `poolSize` | ⚪ Optional | `4` | Connections pooled per `(instance, db)` (1-16) |\n| `idleTimeoutMs` | ⚪ Optional | `300000` | Close an idle `(instance, db)` connection after this long without a command; `0` disables |\n| `connectTimeoutMs` | ⚪ Optional | `5000` | TCP/connect timeout |\n| `commandTimeoutMs` | ⚪ Optional | `15000` | Per-command timeout; `0` disables it (a 60 s socket timeout still applies) |\n| `maxResultItems` | ⚪ Optional | `200` | Per-container item cap |\n| `maxResultChars` | ⚪ Optional | `4000` | Per-string character cap |\n| `maxResultDepth` | ⚪ Optional | `4` | Nested container depth limit |\n| `maxFetchItems` | ⚪ Optional | `1000` | Max items one `execute` bulk read may fetch |\n| `maxFetchChars` | ⚪ Optional | `1000000` | Max bytes one `execute` string read may fetch |\n| `scanCount` | ⚪ Optional | `500` | Default SCAN `COUNT` hint |\n| `maxScanIterations` | ⚪ Optional | `200` | SCAN round-trip cap |\n| `scanTimeBudgetMs` | ⚪ Optional | `10000` | `scan_keys` wall-clock budget |\n\nKeep a config file containing passwords at `chmod 600`. `passwordEnv`/`usernameEnv` are supported if you prefer to inject credentials from the environment (`password` and `passwordEnv` cannot be combined).\n\nUnknown fields (top-level or per instance) are rejected at startup, so a typo aborts the process.\n\n---\n\n## Security model\n\n### Permission modes\n\nThe permission mode is an explicit enum with no `readOnly` boolean, and it defaults to `readonly`:\n\n| Mode | Behavior |\n| :---: | :---: |\n| `readonly` | Only an explicit read-command whitelist is accepted; `SET`, `HSET`, `DEL`, `RESTORE`, ... are rejected. `EVAL`/`FCALL` remain rejected even if `allowScripting` is true. |\n| `readwrite` | Write commands such as `SET`, `HSET`, `DEL` are allowed; the always-rejected list below still applies, and `EVAL`/`FCALL` are allowed only when `allowScripting` is true. |\n\nSet it per instance (`\"mode\"`), for the single-instance environment form (`REDIS_MODE`), or for every instance at once (`--mode`). A Redis ACL with a read-only user is a second layer of defense — `readonly` mode is a convenience, not a replacement for server-side ACLs.\n\n### Always rejected\n\n| Category | Examples |\n| --- | --- |\n| Database / connection state | `SELECT`, `MOVE`, `SWAPDB`, `COPY ... DB`, `MULTI`, `EXEC`, `WATCH`, `RESET`, `HELLO`, `AUTH`, `QUIT` |\n| Pub/sub and streaming | `SUBSCRIBE`, `PSUBSCRIBE`, `MONITOR`, `SYNC`, `PSYNC` |\n| Administration | `CONFIG`, `DEBUG`, `CLIENT`, `ACL`, `MODULE`, `SHUTDOWN`, `SCRIPT`, `FUNCTION` |\n| Topology / replication | `CLUSTER`, `REPLICAOF`, `SLAVEOF`, `FAILOVER`, `MIGRATE`, `REPLCONF` |\n| Destructive / server-wide | `FLUSHDB`, `FLUSHALL`, `SAVE`, `BGSAVE`, `BGREWRITEAOF` |\n| Blocking | `BLPOP`, `BRPOP`, `BLMOVE`, `BZPOPMIN`, `WAIT`, `XREAD`, `XREADGROUP`, ... |\n| Slow key enumeration | `KEYS`, raw `SCAN` — use `scan_keys` |\n\nBlocking commands are rejected because they hold a shared per-database connection and can stall every later request on that DB.\n\n### Lua scripting\n\n`EVAL`, `EVALSHA`, `EVAL_RO`, `EVALSHA_RO`, `FCALL` and `FCALL_RO` are **disabled by default**. `allowScripting: true` / `REDIS_ALLOW_SCRIPTING=1` enables them for trusted callers. In `readonly` mode the read-command whitelist still wins, so scripting stays rejected even with `allowScripting` enabled.\n\n> A Lua script can call commands that the blocklist otherwise rejects, and depending on the Redis version it may be able to reach other logical databases. Treat `allowScripting` as disabling both the blocklist and the `allowedDbs` boundary: only enable it for trusted callers and enforce limits with a Redis ACL.\n\n### Output and fetch bounds\n\nReplies are truncated: `maxResultItems` per array/object, `maxResultChars` per string/buffer, `maxResultDepth` for nesting, and a global item/character budget derived from them so nested replies cannot multiply into gigabytes.\n\n`execute` also checks bulk reads **before** the command runs:\n\n| Shape | Guarded commands |\n| --- | --- |\n| Strings | `GET`, `GETDEL`, `GETEX`, `GETSET`, `SET ... GET`, `GETRANGE`/`SUBSTR`, `MGET` (≤ 100 keys), `HMGET` (≤ 100 fields) |\n| Hash / set / zset | `HGET`, `HGETALL`, `HKEYS`, `HVALS`, `SMEMBERS`, `SINTER`/`SUNION`/`SDIFF`, `ZRANGE`/`ZREVRANGE`/`ZRANGEBY*`, `ZUNION`/`ZINTER`/`ZDIFF` |\n| Lists | `LRANGE`, `LPOS ... COUNT 0` |\n| Streams | `XRANGE`/`XREVRANGE` without `COUNT`, `XINFO STREAM ... FULL`, `XPENDING`, `XAUTOCLAIM` |\n| Aggregates | `SORT`/`SORT_RO` without `LIMIT`, `LCS`, `GEOSEARCH`/`GEORADIUS*`, `DUMP` |\n| Counts | pop and random-member counts, `HSCAN`/`SSCAN`/`ZSCAN` `COUNT`, `MEMORY USAGE ... SAMPLES 0`, `COMMAND`, `SLOWLOG GET` |\n\nUnbounded forms are rejected with `COMMAND_REJECTED` and a pointer to `read_page`; bounded forms still run. The limits are `maxFetchItems` (default 1000) and `maxFetchChars` (default 1,000,000).\n\nThe check is advisory — metadata is read just before the command, so a concurrent writer can still grow the key afterwards — and not exhaustive: `LINDEX` and the `*STORE` variants are not checked, and item-count checks do not bound the byte size of a single field or member.\n\nThe guard and `read_page` issue `STRLEN`, `HSTRLEN`, `LLEN`, `HLEN`, `SCARD`, `ZCARD`, `XLEN`, `TYPE` and `MEMORY USAGE`, so the Redis user must be allowed to run them. A `NOPERM` on a guard command fails the `execute` call; `read_page` treats a failed size probe as unavailable and skips the page-size reduction. Since the byte check uses whole-key memory usage, a very large key can be rejected even when you only read a small page — use `read_page` for page-sized reads.\n\nOther bounds:\n\n- `read_page`: server-side paging; `limit` is validated at 1,000 and capped by `maxFetchItems`. Pass `nextOffset`, `nextCursor` or `nextStart` back unchanged until `complete` is `true`.\n- `scan_keys`: `limit`, `maxScanIterations`, `scanTimeBudgetMs`\n- `maxConnections`: bounds total sockets per instance\n\n### Credentials\n\n- A Redis user must be allowed to run `SELECT` to use any database other than 0. Without `+select`, `db > 0` fails closed with a `DB_ERROR` instead of silently using db 0.\n- Prefer `passwordEnv` / `REDIS_PASSWORD` over inline JSON passwords.\n- Keep a config file containing secrets at `chmod 600`.\n- Error messages redact `password=...`, quoted/JSON password fields, echoed `AUTH` arguments, and any connection URL that may appear in an error.\n- TLS certificate verification is on by default; `tlsRejectUnauthorized: false` disables it and should only be used for self-signed development servers.\n- TLS supports `tls` and `tlsRejectUnauthorized` only; a custom CA or client certificate (`ca`/`cert`/`key`) cannot be configured.\n\n### Transport\n\nThis package exposes a **stdio** MCP server. It does not open an HTTP port and does not implement MCP authentication. The MCP client that launches it is the trust boundary.\n\n### Errors\n\nFailed calls return `isError: true` with a JSON text block `{\"error\": \"...\", \"code\": \"...\"}`. Codes: `CONFIG_ERROR`, `COMMAND_REJECTED`, `COMMAND_SYNTAX`, `COMMAND_ERROR`, `INSTANCE_ERROR`, `DB_ERROR`, `CONNECTION_ERROR`, `INTERNAL_ERROR`. Redis server errors such as `NOPERM` or `WRONGTYPE` map to `COMMAND_ERROR`.\n\n---\n\n## Behavior and limitations\n\n- **No `SELECT`**: logical DB selection is per call — see [Why this exists](#why-this-exists).\n- **Redis Cluster**: only db 0 exists. The server detects `cluster_enabled:1` and rejects db > 0. It connects to a single node, so keys owned by other slots can return `MOVED`; it is not a cluster-aware sharding client.\n- **No transactions**: `MULTI`/`EXEC`/`WATCH` are connection-level and would leak between requests.\n- **No pub/sub or `MONITOR`**: they change the connection mode.\n- **No blocking commands**: they would pin a shared connection. Use non-blocking variants (`XRANGE` instead of blocking `XREAD`, etc.).\n- **Command timeouts are client-side**: the timeout rejects the call but does not cancel the command in Redis, so a timed-out write may still have been applied. Verify state before retrying. `commandTimeoutMs: 0` disables the command timeout, but the 60 s socket timeout still applies, so a command that stays silent for 60 s fails anyway.\n- **Commands in flight during a disconnect are not resent**: a write that was sent when the socket dropped can fail even though Redis may have executed it. Verify state before retrying.\n- **Binary values**: replies are decoded as UTF-8 strings. `DUMP` and other binary payloads may not round-trip; buffers are returned as bounded base64 when the client produces them.\n- **Large reads**: a command the guard does not cover (see [Output and fetch bounds](#output-and-fetch-bounds)) can still be fully materialized before output truncation runs. Prefer `key_info` for metadata, `scan_keys` for enumeration, `read_page` for collections, and a restricted ACL / `commandTimeoutMs` for very large data.\n- **SCAN consistency**: SCAN is incremental and not a snapshot; results can be missed or duplicated across calls.\n- **Connection cache**: each `(instance, db)` pair keeps up to `poolSize` (default 4) pooled connections. The per-instance cap is `maxConnections` (default 32) and is a hard stop. Connections idle for longer than `idleTimeoutMs` (default 5 minutes) are closed automatically; a connection with a command that timed out is dropped immediately and replaced on the next request. Raise `maxConnections` if you legitimately use many logical DBs.\n- **Cluster + ACL**: if `INFO cluster` is denied by ACL, the explicit `SELECT` verification still rejects db > 0 on a cluster with a clear error. db 0 does not require `SELECT`.\n\n---\n\n## Troubleshooting\n\n| Symptom | Check |\n| --- | --- |\n| `DB_ERROR` | `allowedDbs` must contain the requested `db`, and the Redis user needs `+select` for db > 0. |\n| `COMMAND_ERROR` with `NOPERM` | The ACL must allow the size/type commands the fetch guard uses (`STRLEN`, `HSTRLEN`, `LLEN`, `HLEN`, `SCARD`, `ZCARD`, `XLEN`, `TYPE`, `MEMORY USAGE`). |\n| `CONFIG_ERROR` mentioning `references missing environment variable` | `passwordEnv`/`usernameEnv` must be present in the MCP client's `env` block. |\n| `CONFIG_ERROR` mentioning `unknown field(s)` | A JSON field is misspelled; unknown fields abort startup. |\n| `MOVED` | The key lives on another cluster node; only db 0 of a single node is supported. |\n| `CONNECTION_ERROR` | Host/port unreachable, TLS handshake failed, or the server closed the connection. |\n\n---\n\n## License\n\nMIT\n","readmeFilename":"README.md"}