Repolode
Enviar
modelcontextprotocol

modelcontextprotocol/inspector

Ferramenta visual e de linha de comando para testar e depurar servidores Model Context Protocol (MCP), com modos web, CLI e interface de terminal.

Ver no GitHubSite
Estrelas
11,119
Forks
1,545
Issues abertas
26
Último commit
há 13 horas

O que é?

O MCP Inspector permite que desenvolvedores se conectem a servidores Model Context Protocol e inspecionem o que eles oferecem, como tools, resources e prompts, além de chamá-los diretamente para verificar seu comportamento. Ele é distribuído em um único pacote, @modelcontextprotocol/inspector, que disponibiliza o binário mcp-inspector com uma interface web (padrão), uma CLI programável por scripts e uma interface interativa de terminal.

A interface web é um app de página única feito com Vite e React, com backend em Node e construído com Mantine. A CLI foi projetada para automação e CI, permitindo testar um servidor com verificações básicas de conexão, listagem, chamadas e validação de resultados, com saída JSON que pode ser usada com ferramentas como jq. A TUI usa Ink para oferecer uma experiência interativa no terminal.

O pacote também inclui o binário experimental mcpdo, uma CLI de conexão que se conecta uma vez a um servidor nomeado e executa vários comandos por meio de um daemon local. Segredos como tokens OAuth e valores de ambiente do stdio são armazenados no chaveiro do sistema operacional quando disponível, com uma alternativa baseada em arquivos.

Recursos principais

  • 01Interface web para navegar pelas tools, resources e prompts de servidores MCP e executá-los
  • 02CLI programável por scripts para automação, CI e testes básicos, com saída JSON
  • 03Interface interativa de terminal feita com Ink
  • 04Armazena tokens OAuth e segredos no chaveiro do sistema operacional quando disponível
  • 05CLI experimental de conexão mcpdo, que reutiliza uma conexão entre vários comandos

Casos de uso

  • Depurar um servidor MCP personalizado durante o desenvolvimento, antes de conectá-lo a um cliente de IA
  • Executar verificações de conexão, listagem, chamadas e validação em um servidor MCP no CI
  • Testar interativamente ou sem interação servidores MCP protegidos por OAuth
  • Explorar as tools disponíveis em um servidor MCP desconhecido e os respectivos parâmetros de entrada

Início rápido

  1. 1

    Execute a interface web com npx (não é necessário instalar nada)

    npx @modelcontextprotocol/inspector
  2. 2

    Ou execute o cliente de linha de comando

    npx @modelcontextprotocol/inspector --cli

Antes de usar

  • A licença é informada como NOASSERTION, e o README descreve uma transição de licenciamento que combina MIT e Apache-2.0; por isso, confira o LICENSE antes de reutilizar o projeto.
  • Em máquinas sem um chaveiro do sistema operacional, segredos como tokens OAuth são salvos sem criptografia em ~/.mcp-inspector/secrets.json, a menos que você forneça uma chave.
  • O desenvolvimento requer Node 22.19.0 ou superior.

Tópicos

#mcp#model-context-protocol#debugging#testing#cli#typescript#developer-tools#debug#tool#tui

Perguntas frequentes

O que é inspector?
Ferramenta visual e de linha de comando para testar e depurar servidores Model Context Protocol (MCP), com modos web, CLI e interface de terminal. O MCP Inspector permite que desenvolvedores se conectem a servidores Model Context Protocol e inspecionem o que eles oferecem, como tools, resources e prompts, além de chamá-los diretamente para verificar seu comportamento. Ele é distribuído em um único pacote, @modelcontextprotocol/inspector, que disponibiliza o binário mcp-inspector com uma interface web (padrão), uma CLI programável por scripts e uma interface interativa de terminal.
inspector é gratuito? Qual é a licença?
inspector é open source sob a licença Other. Confira os termos da licença antes de usá-lo em produtos comerciais.
inspector ainda é mantido?
Manutenção ativa. O último commit de inspector foi em 21 de out. de 2026.
Para que posso usar inspector?
Depurar um servidor MCP personalizado durante o desenvolvimento, antes de conectá-lo a um cliente de IA Executar verificações de conexão, listagem, chamadas e validação em um servidor MCP no CI Testar interativamente ou sem interação servidores MCP protegidos por OAuth Explorar as tools disponíveis em um servidor MCP desconhecido e os respectivos parâmetros de entrada
Como instalar inspector?
Execute a interface web com npx (não é necessário instalar nada): npx @modelcontextprotocol/inspector Ou execute o cliente de linha de comando: npx @modelcontextprotocol/inspector --cli
Onde consigo inspector?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/modelcontextprotocol/inspector

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados