Ferramenta visual e de linha de comando para testar e depurar servidores Model Context Protocol (MCP), com modos web, CLI e interface de terminal.
MCPJam/inspector
Plataforma open source de testes e avaliação para servidores MCP, que permite inspecionar, conversar com e depurar servidores MCP, apps MCP e apps do ChatGPT.
- Estrelas
- 2,274
- Forks
- 297
- Issues abertas
- 316
- Último commit
- há 5 horas
O que é?
O MCPJam Inspector é uma plataforma de testes e avaliação para desenvolvedores que criam servidores MCP. Ele permite executar ferramentas, recursos, prompts e fluxos de elicitação manualmente, além de visualizar logs completos de JSON-RPC e trocas OAuth durante o processo. O Playground permite conversar com modelos usando seu servidor, incluindo interfaces do OpenAI Apps SDK e de apps MCP, e conta com um emulador de widgets para pré-visualizar layouts nos tamanhos de desktop, tablet e celular.
O projeto também oferece recursos de avaliação e testes de regressão. Você pode definir casos de teste com chamadas de ferramentas esperadas, executá-los com vários LLMs e acompanhar a precisão ao longo do tempo. Um depurador OAuth guiado verifica a conformidade com várias versões da especificação de autorização do MCP, incluindo o registro dinâmico de clientes e CIMD.
Para automação, o MCPJam oferece um CLI e um SDK, e pode executar verificações de conformidade, E2E, avaliação e OAuth em cada pull request no GitHub Actions ou em outros sistemas de CI. Está disponível como app web hospedado, app para desktop no Mac e Windows, ou via npx e Docker.
Recursos principais
- 01Chat no Playground para testar ferramentas com LLMs, com rastreamentos completos de chamadas de ferramentas e mensagens JSON-RPC.
- 02Emulador de widgets para interfaces do OpenAI Apps SDK e de apps MCP, com pré-visualizações para desktop, tablet e celular.
- 03Depurador OAuth guiado que abrange várias versões da especificação de autorização do MCP, DCR e CIMD.
- 04Avaliações com chamadas de ferramentas esperadas e acompanhamento da precisão em vários LLMs.
- 05CLI e SDK para testar servidores e executar verificações pelo terminal ou nos seus próprios testes.
- 06Integração com CI/CD para executar verificações de conformidade, E2E e avaliação em cada PR.
Casos de uso
- Depurar as ferramentas e os prompts de um servidor MCP antes de conectá-lo ao ChatGPT, Claude ou Cursor.
- Verificar passo a passo a configuração OAuth de um servidor MCP para localizar erros de autorização.
- Executar avaliações de regressão com vários LLMs sempre que as definições das ferramentas mudarem.
- Impedir o merge de pull requests que não passem nos testes de conformidade do MCP no GitHub Actions.
Início rápido
- 1
Abra o app hospedado no navegador (não é necessário instalar).
- 2
Ou execute o MCPJam localmente com Node.js 20 ou superior usando npx.
npx @mcpjam/inspector@latest
Antes de usar
- O app web hospedado aceita apenas URLs de servidores HTTPS e não oferece suporte a servidores STDIO.
- A instalação pelo terminal requer Node.js 20 ou superior.
- O app para desktop está disponível apenas para Mac e Windows.
- Os metadados do repositório não indicam uma licença clara (NOASSERTION), embora o README informe Apache 2.0.
Tópicos
Perguntas frequentes
- O que é inspector?
- Plataforma open source de testes e avaliação para servidores MCP, que permite inspecionar, conversar com e depurar servidores MCP, apps MCP e apps do ChatGPT. O MCPJam Inspector é uma plataforma de testes e avaliação para desenvolvedores que criam servidores MCP. Ele permite executar ferramentas, recursos, prompts e fluxos de elicitação manualmente, além de visualizar logs completos de JSON-RPC e trocas OAuth durante o processo. O Playground permite conversar com modelos usando seu servidor, incluindo interfaces do OpenAI Apps SDK e de apps MCP, e conta com um emulador de widgets para pré-visualizar layouts nos tamanhos de desktop, tablet e celular.
- 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 22 de out. de 2026.
- Para que posso usar inspector?
- Depurar as ferramentas e os prompts de um servidor MCP antes de conectá-lo ao ChatGPT, Claude ou Cursor. Verificar passo a passo a configuração OAuth de um servidor MCP para localizar erros de autorização. Executar avaliações de regressão com vários LLMs sempre que as definições das ferramentas mudarem. Impedir o merge de pull requests que não passem nos testes de conformidade do MCP no GitHub Actions.
- Como instalar inspector?
- Abra o app hospedado no navegador (não é necessário instalar). Ou execute o MCPJam localmente com Node.js 20 ou superior usando npx.: npx @mcpjam/inspector@latest
- Onde consigo inspector?
- O código-fonte e as instruções de instalação estão no GitHub: https://github.com/MCPJam/inspector
Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.
Projetos relacionados
Interface de terminal e CLI para testar, depurar e automatizar servidores Model Context Protocol (MCP) via stdio, SSE e HTTP.
Uma CLI que instala servidores MCP em clientes de IA populares, como Claude Desktop, Cursor e VS Code, incluindo autenticação OAuth para servidores remotos.
Framework TypeScript para criar servidores MCP, MCP Apps com visualizações em React e clientes, com Inspector e CLI integrados.
Biblioteca para Python e TypeScript com avaliadores prontos e personalizáveis para testar resultados de aplicações com LLM, incluindo avaliação por LLM como juiz.
Ambiente de desenvolvimento Ethereum para compilar, implantar, testar e depurar smart contracts e dapps.