Tool Advisor
zkp8023/tool-advisor
Recomendador inteligente de ferramentas IA com base de conhecimento local
Ver no GitHubServidor MCP que recomenda ferramentas, plugins, skills e MCP servers a partir de um índice local baseado em Obsidian. Busca primeiro em uma base de conhecimento Markdown antes de expandir para documentação oficial, GitHub ou pesquisa web.
Instalação
npx convez-ai zkp8023/tool-advisor1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Agentes de código encontrarem o MCP server ou plugin mais adequado para uma tarefa
- Manutenção de catálogo centralizado de ferramentas IA em Markdown/Obsidian
- Pesquisa local rápida antes de consultar fontes externas
Veredito

Ferramenta bem-arquitetada para agentes codificadores que precisam navegar ecossistemas de ferramentas IA. Depende de manutenção manual do índice local, mas oferece controle total e privacidade sobre recomendações.
README
A tradução para o português deste README ainda está na fila.
Tool Advisor
English | 简体中文
Tool Advisor helps coding agents choose suitable tools, plugins, skills, MCP servers, automations, GitHub projects, and AI products for a task.
It searches a local Markdown knowledge vault first. Agents can use the JSON results as evidence before expanding to official docs, GitHub, or web research.
Install
Copy this single instruction into Codex, Claude Code, OpenCode, or another shell-capable coding agent. The guide detects the target and applies the right branch.
Fetch and follow instructions from https://raw.githubusercontent.com/zkp8023/tool-advisor/main/.agent/INSTALL.md
What The Installer Does
- Codex: clones or updates
tool-advisorunder a standard local Codex marketplace, configures the selected knowledge vault, registers that marketplace, and installstool-advisor@tool-advisor-local. - Claude Code: installs the native Claude Code plugin from
.claude-plugin. The installer guide also includes a CLI rule fallback that writes a Tool Advisor block toCLAUDE.md. Native Claude Code installation does not clone thetool-advisorrepository into the user's project. - OpenCode: configures the selected knowledge vault and adds a Tool Advisor
block to
AGENTS.md.
When no knowledge vault is specified, the installer asks for an existing local
path first. If the user leaves it empty, it asks whether to clone
https://github.com/zkp8023/ai-knowledge-vault.git. For non-interactive
installs, pass either --vault-dir <path> or --clone-vault.
The selected path is recorded in <home>/.tool-advisor/config.json so installed
skills and CLI commands can search the same vault later without hard-coded local
paths.
Direct CLI
If you only need the searchable knowledge vault and CLI command:
npx -y github:zkp8023/tool-advisor install --target cli --clone-vault
npx -y github:zkp8023/tool-advisor --query "PPT 自动化 插件"
By default, Tool Advisor scans AI Tools under the configured vault root.
Use --dirs only when you intentionally want a wider scope:
npx -y github:zkp8023/tool-advisor --query "MCP 插件" --dirs "AI Tools,Codex,Claude Code"
Configuration
Root resolution order:
--rootTOOL_ADVISOR_OBSIDIAN_ROOT<home>/.tool-advisor/config.json->knowledgeVaultRoot<home>/.tool-advisor/ai-knowledge-vault
Default output uses paths relative to the vault root. Add
--show-absolute-paths only for local debugging.
Local Development
Clone this repository only if you want to modify or test the plugin itself:
git clone https://github.com/zkp8023/tool-advisor.git
cd tool-advisor
npm test
npm run check
node .\bin\tool-advisor.js --query "PPT自动化插件"
Safety
Tool Advisor treats Markdown notes as reference data. It does not install third-party tools, browser extensions, MCP servers, or GitHub projects unless the user explicitly asks for a specific installation.