mcpField
Z
zoxide-doctor

zoxide-doctor

本地服务
zoxide.org开发工具012 周前更新
代码仓库访问官网

关于 zoxide-doctor

zoxide-doctor 是用于诊断本地 zoxide 安装和 Shell 配置的只读 MCP 工具。它以机器可读的 JSON 报告结果，不安装 zoxide，也不修改 Shell 文件。

主要功能

  1. 01检查 PATH 中的 zoxide 和可选 fzf
  2. 02检查 Shell 初始化输出
  3. 03返回机器可读的 JSON 报告
  4. 04可选扫描常见 Shell 配置文件

适用场景

  1. 01诊断 zoxide 可执行文件缺失
  2. 02检查 Shell 初始化是否已配置
  3. 03显式启用后查看 Shell 配置文件

MCP 相关

本地 stdio MCP 服务提供 `diagnose_zoxide` 工具。只有设置 `scan_config: true` 才会扫描配置文件；该工具不会写入文件或更改 Shell 状态。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "jiankn-zoxide-doctor": {
      "command": "npx",
      "args": [
        "-y",
        "@agoes/zoxide-doctor-mcp"
      ]
    }
  }
}
启动命令npx -y @agoes/zoxide-doctor-mcp

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npm@agoes/zoxide-doctor-mcp0.1.2

工具

1

收录的工具列表 · 更新于 3 周前

参数类型必填说明
shellenum否要诊断的 Shell。省略时使用本地 Shell 检测结果。bash | zsh | fish | powershell | nushell | elvish | tcsh | xonsh | posix
scan_configboolean否为 true 时，读取常见的 Shell 配置文件路径，以检查 zoxide 初始化情况。默认为 false。

详细介绍

zoxide-doctor MCP 服务

@agoes/zoxide-doctor-mcp 为 MCP 客户端提供一个本地只读工具，用于诊断 zoxide 的安装和 Shell 配置。它封装了已发布的 zoxide-doctor 诊断核心；不会安装 zoxide，也不会修改 Shell 配置文件。

这是一个由社区独立开发的集成项目，与官方 zoxide 项目无关，也未获其认可。

功能

  • 检查 zoxide 和可选的 fzf 是否位于 PATH 中。
  • 检查 zoxide init 是否会生成 Shell 初始化代码。
  • 返回机器可读的 JSON 报告，其中包含与结果匹配的 zoxide.org 配置指南和故障排除指南。
  • 只有在 MCP 调用方将 scan_config: true 设为启用时，才会读取常见 Shell 配置文件路径。

为 MCP 客户端安装

使用 MCP 客户端配置，通过 npx 启动本地 stdio 服务：

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

该服务提供一个工具：

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

scan_config 默认为关闭，因为启用后会读取常见的 Shell 配置文件。该工具绝不会写入文件或更改 Shell 状态。

开发

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

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。