https://github.com/modelcontextprotocol/inspector
O MCP Inspector é uma ferramenta de teste e depuração visual para servidores Model Context Protocol (MCP), projetada para facilitar o desenvolvimento, validação e segurança de integrações entre aplicações de linguagem natural e ferramentas externas.[1][2][3]
Conceito Fundamental
O MCP Inspector serve como ponte entre servidores MCP e desenvolvedores, permitindo testar comandos, recursos e prompts antes da implantação em produção. Ele valida a conformidade com o protocolo, descobre vulnerabilidades e garante que agentes de IA atuem conforme esperado em ambientes integrados.[4][2][3][1]
Principais Funcionalidades
- Conexão com servidores MCP: Oferece opções flexíveis de transporte (stdio, HTTP/SSE, streamable-http) e configuração de ambiente.[3][5]
- Testes interativos: Permite explorar recursos, prompts e ferramentas do servidor MCP através de interface gráfica, facilitando testes de parâmetros, visualização de resultados e validações rápidas.[6][2]
- Histórico e exportação: Mantém um log completo das interações para análise e regressão, além de exportação em JSON para documentação ou automação de testes.[3]
- Modo CLI: Possibilita integração em pipelines CI/CD, testes programáticos e automação de tarefas usando comandos como
npx @modelcontextprotocol/inspector.[5][1][3]
Comandos Comuns
| Descrição | Comando de exemplo |
|---|---|
| Uso básico | npx @modelcontextprotocol/inspector --cli node build/index.js |
| Testar servidor remoto | npx @modelcontextprotocol/inspector --cli https://meu-mcp-server.exemplo.com |
| Listar ferramentas | npx @modelcontextprotocol/inspector --cli node build/index.js --method tools/list |
| Chamar ferramenta específica | npx @modelcontextprotocol/inspector --cli node build/index.js --method tools/call --tool-name nome_da_ferramenta --tool-arg chave=valor |
Casos de Uso
- Debug visual de servidores MCP em ambientes locais ou remotos.
- Validação de conformidade com especificações MCP e segurança, incluindo testes para vulnerabilidades específicas de agentes de IA.
- Facilitação da integração de agentes e interfaces LLM com ferramental externo, utilizando interface gráfica intuitiva e automação via CLI.
Recomendações
O MCP Inspector é essencial em fluxos de desenvolvimento que envolvem IA, especialmente para garantir segurança, integridade e interoperabilidade entre agentes e servidores MCP. Ele pode ser integrado nos testes de unidade, pipelines de automação e validação de produção para antecipar problemas decorrentes de uso indevido ou falhas de configuração.[2][4][1][5][3]