About
Read-only local zoxide diagnostics for MCP clients.
Security Report
Valid MCP server (1 strong, 3 medium validity signals). No known CVEs in dependencies. Package registry verified. Imported from the Official MCP Registry.
7 files analyzed · 1 issue found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
Permissions Required
This plugin requests these system permissions. Most are normal for its category.
How to Install
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-jiankn-zoxide-doctor": {
"args": [
"-y",
"@agoes/zoxide-doctor-mcp"
],
"command": "npx"
}
}
}Documentation
View on GitHubFrom the project's GitHub README.
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
zoxideand optionalfzfare onPATH. - Checks that
zoxide initproduces 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
Reviews
No reviews yet
Be the first to review this server!
More Developer Tools MCP Servers
Git
Freeby Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
mcp-creator-python
Freeby mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.
MarkItDown
Freeby Microsoft · Content & Media
Convert files (PDF, Word, Excel, images, audio) to Markdown for LLM consumption
MCP Marketplace
Freeby mcp-marketplace · Developer Tools
Search and install MCP servers from inside your AI client.
FinAgent
Freeby mcp-marketplace · Finance
Free stock data and market news for any MCP-compatible AI assistant.