zoxide-doctor

zoxide-doctor MCP サーバー

@agoes/zoxide-doctor-mcp は、zoxide のインストールとシェルのセットアップを診断するための、ローカルで読み取り専用のツールを 1 つ MCP クライアントに提供します。公開されている zoxide-doctor の診断コアをラップしており、zoxide のインストールやシェル設定ファイルの変更は行いません。

これは独立したコミュニティによる統合です。公式の zoxide プロジェクトとは提携しておらず、承認も受けていません。

機能

• zoxide と任意の fzf が PATH 上にあるか確認します。
• zoxide init がシェル初期化コードを生成するか確認します。
• 対応する zoxide.org のセットアップガイドとトラブルシューティングガイドを含む、機械可読な JSON レポートを返します。
• MCP 呼び出し元が scan_config: true を設定した場合にのみ、一般的なシェルのプロファイルパスを読み取ります。

MCP クライアントへのインストール

npx を使ってローカルの stdio サーバーを起動する MCP クライアント設定を使用します。

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

サーバーは 1 つのツールを公開します。

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

scan_config は一般的なシェルのプロファイルファイルを読み取るため、明示的に有効にする必要があります。このツールがファイルを書き込んだり、シェルの状態を変更したりすることはありません。

開発

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

server.json は package.json とバージョンを一致させており、MCP Registry の websiteUrl には zoxide-doctor のガイド を設定しています。

ライセンス

MIT