English Français العربية

zoxide-doctor

السجل الرسمي الصحة

Read-only local zoxide diagnostics for MCP clients.

الشيفرة المصدرية الموقع التوثيق

ماذا يمكنك أن تفعل مع zoxide-doctor؟

  • Checks whether zoxide and optional fzf are on PATH.
  • Checks that zoxide init produces shell initialization code.
  • Returns a machine-readable JSON report, including the matching zoxide.org setup and troubleshooting guides.
  • Reads conventional shell profile paths only when the MCP caller sets scan_config: true.

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package @agoes/zoxide-doctor-mcp
Claude Code 
claude mcp add zoxide-doctor -- npx -y @agoes/zoxide-doctor-mcp@0.1.2
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "zoxide-doctor": {
            "command": "npx",
            "args": [
                "-y",
                "@agoes/zoxide-doctor-mcp@0.1.2"
            ]
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. zoxide-doctor MCP server
  2. What it does
  3. Install for an MCP client
  4. Development
  5. License

zoxide-doctor MCP server

@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 diagnostic core; it does not install zoxide or modify shell configuration files.

This is an independent community integration. It is not affiliated with or endorsed by the official zoxide project.

What it does

  • Checks whether zoxide and optional fzf are on PATH.
  • Checks that zoxide init produces shell initialization code.
  • Returns a machine-readable JSON report, including the matching zoxide.org setup and troubleshooting guides.
  • Reads conventional shell profile paths only when the MCP caller sets scan_config: true.

Install for an MCP client

Use an MCP client configuration that starts the local stdio server with npx:

{
  "mcpServers": {
    "zoxide-doctor": {
      "command": "npx",
      "args": ["-y", "@agoes/zoxide-doctor-mcp"]
    }
  }
}

The server exposes one tool:

diagnose_zoxide({ shell?: "bash" | "zsh" | "fish" | "powershell" | "nushell" | "elvish" | "tcsh" | "xonsh" | "posix", scan_config?: boolean })

scan_config is opt-in because it reads conventional shell-profile files. The tool never writes files or changes shell state.

Development

npm install
npm run lint
npm test
npm run validate:metadata
npm run pack:check
npm run smoke

server.json is kept version-locked to package.json and sets the MCP Registry websiteUrl to the zoxide-doctor guide.

License

MIT

الأسئلة الشائعة

ما هو zoxide-doctor؟

Read-only local zoxide diagnostics for MCP clients.

كيف أثبّت zoxide-doctor؟

يعمل على جهازك. في Claude Code: claude mcp add zoxide-doctor -- npx -y @agoes/zoxide-doctor-mcp@0.1.2. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج zoxide-doctor إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل zoxide-doctor مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون zoxide-doctor؟

ينشره jiankn. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.