{"_id":"@agoes/zoxide-doctor-mcp","_rev":"2-cea2044ccdb7dd9e2221662115445784","name":"@agoes/zoxide-doctor-mcp","dist-tags":{"latest":"0.1.2"},"versions":{"0.1.1":{"name":"@agoes/zoxide-doctor-mcp","version":"0.1.1","keywords":["mcp","model-context-protocol","zoxide","diagnostics","shell","cli"],"author":{"name":"jiankn"},"license":"MIT","_id":"@agoes/zoxide-doctor-mcp@0.1.1","maintainers":[{"name":"agoes","email":"jayanataagoes144@gmail.com"}],"homepage":"https://zoxide.org/tools/zoxide-doctor/","bugs":{"url":"https://github.com/jiankn/zoxide-doctor-mcp/issues"},"bin":{"zoxide-doctor-mcp":"bin/zoxide-doctor-mcp.js"},"dist":{"shasum":"f95424b0fb3024aeb3a91156b169781ed87fb9bf","tarball":"https://registry.npmjs.org/@agoes/zoxide-doctor-mcp/-/zoxide-doctor-mcp-0.1.1.tgz","fileCount":8,"integrity":"sha512-3rUle/k25W93mM6v+wZrzp+HGh9QQDbPPZfxoqWJzGOboLq45zXeLyJdahkLZxfgPFQAXq9WA1DMxnhZTPRWsQ==","signatures":[{"sig":"MEUCIQC29ZiNvve0jaqHRU0cQj/+e2xGPb7OoL819Ob1x7etTgIgKXlQ53/crCvVydo13cNo08KZoeijFbXOMq+eEzkOAO0=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@agoes%2fzoxide-doctor-mcp@0.1.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":9954},"type":"module","engines":{"node":">=20"},"exports":"./src/server.js","gitHead":"846f8d33a7271ccd8686ad8d3913f85d02c115fa","mcpName":"io.github.jiankn/zoxide-doctor","scripts":{"lint":"node --check bin/zoxide-doctor-mcp.js && node --check src/server.js && node --check scripts/smoke-test.mjs && node --check scripts/validate-server-json.mjs && node --check test/server.test.js","test":"node --test test/server.test.js","smoke":"node scripts/smoke-test.mjs","pack:check":"npm pack --dry-run","validate:metadata":"node scripts/validate-server-json.mjs"},"_npmUser":{"name":"agoes","email":"jayanataagoes144@gmail.com"},"repository":{"url":"git+https://github.com/jiankn/zoxide-doctor-mcp.git","type":"git"},"_npmVersion":"10.8.2","description":"Read-only zoxide diagnostics for MCP clients","directories":{},"_nodeVersion":"20.20.2","dependencies":{"zod":"^4.4.3","zoxide-doctor":"^0.1.0","@modelcontextprotocol/server":"^2.0.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/zoxide-doctor-mcp_0.1.1_1786256146530_0.50652369252896","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@agoes/zoxide-doctor-mcp","version":"0.1.2","description":"Read-only zoxide diagnostics for MCP clients","type":"module","bin":{"zoxide-doctor-mcp":"bin/zoxide-doctor-mcp.js"},"exports":"./src/server.js","scripts":{"lint":"node --check bin/zoxide-doctor-mcp.js && node --check src/server.js && node --check scripts/smoke-test.mjs && node --check scripts/validate-server-json.mjs && node --check test/server.test.js","test":"node --test test/server.test.js","validate:metadata":"node scripts/validate-server-json.mjs","pack:check":"npm pack --dry-run","smoke":"node scripts/smoke-test.mjs"},"engines":{"node":">=20"},"keywords":["mcp","model-context-protocol","zoxide","diagnostics","shell","cli"],"homepage":"https://zoxide.org/tools/zoxide-doctor/","repository":{"type":"git","url":"git+https://github.com/jiankn/zoxide-doctor-mcp.git"},"bugs":{"url":"https://github.com/jiankn/zoxide-doctor-mcp/issues"},"author":{"name":"jiankn"},"license":"MIT","mcpName":"io.github.jiankn/zoxide-doctor","dependencies":{"@modelcontextprotocol/server":"^2.0.0","zod":"^4.4.3","zoxide-doctor":"^0.1.0"},"_id":"@agoes/zoxide-doctor-mcp@0.1.2","gitHead":"e9429c45a840d85928e879144072c0c91116224b","_nodeVersion":"20.20.2","_npmVersion":"10.8.2","dist":{"integrity":"sha512-c+BRYg2kUWB1+UYifxgGW8rhoRM6bL1DcgUfP+CE3S1aYpkMp6l0pcQwprrsgd3J1xJy1e7kfdLcA1EEW0o+6A==","shasum":"0c1b3b90bc46d9df22225014b0c7a722e77e0fe5","tarball":"https://registry.npmjs.org/@agoes/zoxide-doctor-mcp/-/zoxide-doctor-mcp-0.1.2.tgz","fileCount":8,"unpackedSize":9964,"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@agoes%2fzoxide-doctor-mcp@0.1.2","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIDwZHHX0CBWogZtj2rVa+HRYwIhtFObgy0aDCsQ8u3i+AiEA8pfye/n3GQFDYlHMPzzJOx5eAOEc8Vg7/EXvqE8UeBs="}]},"_npmUser":{"name":"agoes","email":"jayanataagoes144@gmail.com"},"directories":{},"maintainers":[{"name":"agoes","email":"jayanataagoes144@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/zoxide-doctor-mcp_0.1.2_1786256396317_0.47711470230358"},"_hasShrinkwrap":false}},"time":{"created":"2026-08-09T06:15:46.396Z","modified":"2026-08-09T06:19:56.778Z","0.1.1":"2026-08-09T06:15:46.668Z","0.1.2":"2026-08-09T06:19:56.459Z"},"bugs":{"url":"https://github.com/jiankn/zoxide-doctor-mcp/issues"},"author":{"name":"jiankn"},"license":"MIT","homepage":"https://zoxide.org/tools/zoxide-doctor/","keywords":["mcp","model-context-protocol","zoxide","diagnostics","shell","cli"],"repository":{"type":"git","url":"git+https://github.com/jiankn/zoxide-doctor-mcp.git"},"description":"Read-only zoxide diagnostics for MCP clients","maintainers":[{"name":"agoes","email":"jayanataagoes144@gmail.com"}],"readme":"# zoxide-doctor MCP server\n\n`@agoes/zoxide-doctor-mcp` gives MCP clients one local, read-only tool for diagnosing zoxide installation and shell setup. It wraps the published [`zoxide-doctor`](https://zoxide.org/tools/zoxide-doctor/) diagnostic core; it does not install zoxide or modify shell configuration files.\n\nThis is an independent community integration. It is not affiliated with or endorsed by the official zoxide project.\n\n## What it does\n\n- Checks whether `zoxide` and optional `fzf` are on `PATH`.\n- Checks that `zoxide init` produces shell initialization code.\n- Returns a machine-readable JSON report, including the matching zoxide.org setup and troubleshooting guides.\n- Reads conventional shell profile paths only when the MCP caller sets `scan_config: true`.\n\n## Install for an MCP client\n\nUse an MCP client configuration that starts the local stdio server with `npx`:\n\n```json\n{\n  \"mcpServers\": {\n    \"zoxide-doctor\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@agoes/zoxide-doctor-mcp\"]\n    }\n  }\n}\n```\n\nThe server exposes one tool:\n\n```text\ndiagnose_zoxide({ shell?: \"bash\" | \"zsh\" | \"fish\" | \"powershell\" | \"nushell\" | \"elvish\" | \"tcsh\" | \"xonsh\" | \"posix\", scan_config?: boolean })\n```\n\n`scan_config` is opt-in because it reads conventional shell-profile files. The tool never writes files or changes shell state.\n\n## Development\n\n```bash\nnpm install\nnpm run lint\nnpm test\nnpm run validate:metadata\nnpm run pack:check\nnpm run smoke\n```\n\n`server.json` is kept version-locked to `package.json` and sets the MCP Registry `websiteUrl` to the [zoxide-doctor guide](https://zoxide.org/tools/zoxide-doctor/).\n\n## License\n\nMIT\n","readmeFilename":"README.md"}