/ Diretório / Playground / Everything (test server)
● Oficial modelcontextprotocol ⚡ Instantâneo

Everything (test server)

por modelcontextprotocol · modelcontextprotocol/servers

Servidor de teste de referência MCP — cada recurso do protocolo em um único lugar. Para depurar seu cliente MCP, não para uso em produção.

O servidor 'tudo' de referência. Expõe cada capacidade MCP: ferramentas (síncronas e de longa execução), recursos (estáticos e dinâmicos), prompts, sampling, conclusão. Use para confirmar que sua implementação de cliente MCP funciona, ou para ensinar/aprender o protocolo. Não se destina a fluxos de trabalho reais.

Por que usar

Principais recursos

Demo ao vivo

Como fica na prática

everything.replay ▶ pronto
0/0

Instalar

Escolha seu cliente

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "everything": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-everything"
      ]
    }
  }
}

Abra Claude Desktop → Settings → Developer → Edit Config. Reinicie após salvar.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "everything": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-everything"
      ]
    }
  }
}

Cursor usa o mesmo esquema mcpServers que o Claude Desktop. Config de projeto vence a global.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "everything": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-everything"
      ]
    }
  }
}

Clique no ícone MCP Servers na barra lateral do Cline, depois "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "everything": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-everything"
      ]
    }
  }
}

Mesmo formato do Claude Desktop. Reinicie o Windsurf para aplicar.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "everything",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-everything"
      ]
    }
  ]
}

O Continue usa um array de objetos de servidor em vez de um map.

~/.config/zed/settings.json
{
  "context_servers": {
    "everything": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "@modelcontextprotocol/server-everything"
        ]
      }
    }
  }
}

Adicione em context_servers. Zed recarrega automaticamente ao salvar.

claude mcp add everything -- npx -y @modelcontextprotocol/server-everything

Uma linha só. Verifique com claude mcp list. Remova com claude mcp remove.

Casos de uso

Usos do mundo real: Everything (test server)

Verifique se sua implementação de cliente MCP lida com cada recurso do protocolo

👤 Desenvolvedores construindo ou depurando clientes MCP, SDKs ou integrações ⏱ ~20 min intermediate

Quando usar: Você está lançando um novo cliente MCP, integração ou wrapper e quer provar que lida com ferramentas+recursos+prompts+sampling antes de apontar para um servidor real.

Pré-requisitos
  • Seu cliente MCP em teste — Claude Desktop, seu cliente customizado, ou um test harness
Fluxo
  1. Inicie o servidor everything e liste suas capacidades
    Conecte-se ao servidor everything. Liste cada ferramenta, recurso e prompt que expõe.✓ Copiado
    → Inventário completo — confirma que seu cliente pode descobrir a superfície completa
  2. Exercite cada capacidade
    Chame echo, depois add, depois longRunningOperation com duração de 10s. Leia o recurso estático e um dinâmico. Invoque o prompt simple_prompt.✓ Copiado
    → Cada chamada completa ou faz stream corretamente; cancelamento funciona
  3. Teste casos extremos
    Tente sampling (ferramenta sampleLLM), conclusão em um argumento de prompt, e uma ferramenta com erro deliberado. Verifique se seu cliente lida com cada caminho.✓ Copiado
    → Sem travamentos; erros aparecem com códigos de erro MCP apropriados

Resultado: Uma matriz verificada de recursos MCP que seu cliente implementa, com evidências.

Armadilhas
  • Nem todos os clientes implementam sampling — Sampling é opcional para o cliente; se o seu não o suporta, a ferramenta sampleLLM exibirá um erro claro — esperado, não é um bug

Aprenda o protocolo MCP inspecionando um servidor real

👤 Desenvolvedores novos em MCP que leram a especificação e querem vê-la ao vivo ⏱ ~45 min intermediate

Quando usar: Você está estudando o protocolo e quer um servidor cujo código-fonte você também possa ler lado a lado.

Fluxo
  1. Execute o servidor com transporte stdio e observe o tráfego
    Execute npx -y @modelcontextprotocol/server-everything e conecte um cliente. Capture a troca JSON-RPC (lista de ferramentas, chamada, resposta).✓ Copiado
    → Frames de protocolo brutos que você pode mapear para a especificação
  2. Leia o código-fonte correspondente
    Abra modelcontextprotocol/servers/src/everything — rastreie qual arquivo implementa os handlers de ferramenta, recurso, prompt que você acabou de ver.✓ Copiado
    → Mapeamento 1:1 entre protocolo de fio e código do servidor
  3. Modifique e teste
    Faça fork do servidor, adicione uma nova ferramenta que retorna o uptime atual do servidor, reinicie e chame-a.✓ Copiado
    → Sua nova ferramenta aparece em list_tools e responde a chamadas

Resultado: Você entende MCP no nível do protocolo, não apenas no nível SDK.

Armadilhas
  • Tratar recursos do everything-server como padrões prontos para produção — O servidor é deliberadamente sobre-featored para testes; servidores reais devem expor apenas ferramentas que você realmente precisa
Combine com: fastmcp

Combinações

Combine com outros MCPs para 10× de alavancagem

everything + fastmcp

Teste se seu servidor construído com FastMCP se comporta como a referência

Conecte-se aos meus servidores FastMCP e everything. Para cada capacidade que o servidor everything expõe, verifique se meu servidor a trata de forma equivalente.✓ Copiado
everything + mcp-agent

Execute evals de agente contra um servidor com comportamentos conhecidos

Configure um mcp-agent apontando para o servidor everything. Execute um conjunto de testes que valida fluxos de chamada de ferramenta, leitura de recurso e invocação de prompt.✓ Copiado

Ferramentas

O que este MCP expõe

FerramentaEntradasQuando chamarCusto
echo message: str Teste de fumaça: confirme que request/response funciona free
add a: number, b: number Teste de entrada tipada simples free
longRunningOperation duration: int (seconds), steps: int Teste caminhos de streaming/progresso + cancelamento em seu cliente free
sampleLLM prompt: str, maxTokens: int Teste recurso de sampling MCP — servidor solicita ao cliente executar uma chamada LLM depends on client's sampling backend
getTinyImage none Teste entrega de recurso binário free
printEnv none Diagnostique quais variáveis env seu cliente MCP passa free
annotatedMessage messageType: str, includeImage: bool Teste renderização de conteúdo anotado (prioridade, público) free

Custo e limites

O que custa rodar

Cota de API
Nenhuma — totalmente local
Tokens por chamada
Minúsculo
Monetário
Gratuito
Dica
Única preocupação: longRunningOperation e sampleLLM podem custar tempo real ou tokens no LLM do seu cliente; mantenha as execuções de teste curtas.

Segurança

Permissões, segredos, alcance

Armazenamento de credenciais: Nenhuma
Saída de dados: Nenhuma por padrão; printEnv expõe quaisquer variáveis env que seu cliente passou — não a aponte para um processo com segredos durante demo

Solução de problemas

Erros comuns e correções

Cliente não mostra ferramentas após conexão

Confirme que o transporte stdio corresponde. Alguns clientes exigem que o processo do servidor seja de longa vida; verifique se a configuração 'command' do seu cliente é executada sem sair.

Verificar: Run `npx -y @modelcontextprotocol/server-everything` directly; it should block waiting for input
sampleLLM retorna 'sampling not supported'

Seu cliente não implementa sampling MCP (muitos não). Esperado para a maioria dos clientes hoje. Pule essa ferramenta.

longRunningOperation não faz stream de progresso

Seu cliente pode não se inscrever em notificações de progresso. Verifique sua documentação para suporte a handlers de progresso.

Alternativas

Everything (test server) vs. outros

AlternativaQuando usarTroca
FastMCPVocê quer construir seu próprio servidor de teste, não usar a referênciaMais trabalho; permite isolar comportamentos específicos
Qualquer servidor real (github, filesystem, etc.)Você quer testar contra superfícies de ferramentas realistas e estreitas em vez da cozinha completaSuperfície menor — pode perder recursos que seu cliente precisa suportar

Mais

Recursos

📖 Leia o README oficial no GitHub

🐙 Ver issues abertas

🔍 Ver todos os 400+ servidores MCP e Skills