Testare un server MCP in locale: sei chiamate che tolgono il dubbio

Un server MCP si prova con sei chiamate: initialize, tools/list, tools/call, una notifica, un metodo inesistente e un token sbagliato. Se le risposte tornano come dice la specifica, il server è pronto per un client.

Prima l'handshake

curl -s https://ui.eneawork.it/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize"}'

Controlla tre campi: protocolVersion 2025-06-18, l'oggetto capabilities e serverInfo.name. Se il server dichiara solo tools, non aspettarti prompt né sampling: la lista vuota è coerente, non un guasto.

Poi l'elenco e una chiamata

curl -s https://ui.eneawork.it/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'

curl -s https://ui.eneawork.it/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"search_components","arguments":{"query":"data table","limit":2}}}'

L'elenco deve contenere 9 strumenti con il proprio schema di input; la chiamata restituisce contenuto testuale con URL e comando di installazione. Una query senza risultati produce un messaggio con isError: true, non un errore JSON-RPC.

Le risposte che nessuno prova

L'ultima riga è il difetto più comune: il parser di Express risponde prima del dispatcher, quindi l'errore arriva in HTML e un client che legge solo JSON lo interpreta come guasto di rete.

Il rate limit si prova contando

Il traffico anonimo passa da un limite per IP, RATE_MCP_PER_MIN, 120 al minuto se la variabile non è impostata; il traffico autenticato ha una quota per piano. Al superamento arriva 429 con Retry-After: 60 e codice -32002.

for i in $(seq 1 3); do
  curl -s -o /dev/null -w "%{http_code}\n" https://ui.eneawork.it/mcp \
    -H "Content-Type: application/json" \
    -d '{"jsonrpc":"2.0","id":1,"method":"ping"}'
done

Una prova in locale, senza scrivere il client

Avvia il server con npm start, esporta RATE_MCP_PER_MIN=5 e ripeti il ciclo: il 429 deve arrivare alla sesta chiamata. Se non arriva, il contatore è per account oppure non è montato sul percorso giusto.

Il catalogo EneUI

Le prove usano record reali: modali, hero e la modale animata di Aceternity, licenza MIT e 290 stelle dichiarate a monte, letta il 1 novembre 2026.

La limitazione

Il server risponde 200 anche quando il corpo contiene un errore JSON-RPC: chi controlla solo lo stato HTTP considera riuscita una chiamata fallita. Il test deve leggere error e isError, non il codice di stato.

Dove continuare

Il flusso OAuth e il 401 sono in OAuth per server MCP; i metodi sono in come costruire un server MCP; lo schema degli strumenti è in progettare un tool MCP. Resource e tool a confronto sono in resources e tools in MCP.