{
  "markdown": "# 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",
  "bytes": 1645,
  "sha": "aa679ca3bbfe3e8a1b9510fefd43ba80e02269999f46d96095d6d3ce6d08b78e",
  "repo_slug": "jiankn/zoxide-doctor-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_jiankn_zoxide_doctor_f685fa23/readme"
}