Content
# AiCircus — MCP examples
Esempi minimali e funzionanti di **server MCP (Model Context Protocol)** in TypeScript e Python, pronti da collegare a Claude o ad altri client compatibili. Mantenuti da **[AiCircus](https://aicircus.it)**, il verticale AI di [ShadApps](https://www.shadapps.it).
> **Cos'è MCP?** Il Model Context Protocol è uno standard aperto che permette a un modello AI (come Claude) di usare strumenti esterni — leggere file, interrogare API, chiamare i tuoi sistemi — in modo uniforme. In pratica è il "linguaggio" con cui un agente AI parla ai tuoi tool. Approfondimento: [MCP: il linguaggio degli agenti AI](https://aicircus.it/blog/mcp-agenti-claude).
## Esempi
| Esempio | Linguaggio | Cosa mostra |
|---|---|---|
| [`examples/typescript-echo`](examples/typescript-echo) | TypeScript | Server MCP minimale via stdio con un tool `echo`, usando l'SDK ufficiale `@modelcontextprotocol/sdk`. |
| [`examples/python-echo`](examples/python-echo) | Python | Lo stesso server con `FastMCP` (pacchetto `mcp`). |
Ogni esempio espone un tool `echo` che ripete il messaggio ricevuto: il punto di partenza più semplice per capire la struttura di un server MCP, da cui poi crescere verso tool reali (lettura documenti, query a un database, chiamate al tuo CRM/ERP).
### TypeScript — avvio rapido
```bash
cd examples/typescript-echo
npm install
npm run build && npm start # server MCP su stdio
```
### Python — avvio rapido
```bash
cd examples/python-echo
pip install -r requirements.txt
python server.py # server MCP su stdio
```
### Collegarlo a Claude Desktop
Aggiungi il server al file di configurazione di Claude Desktop (`claude_desktop_config.json`):
```json
{
"mcpServers": {
"aicircus-echo": {
"command": "python",
"args": ["/percorso/assoluto/examples/python-echo/server.py"]
}
}
}
```
Riavvia Claude Desktop: il tool `echo` comparirà tra gli strumenti disponibili.
## Chi siamo
**AiCircus** è il verticale AI di **ShadApps S.r.l.** (Milano). Costruiamo agenti AI su misura, automazione di processi, integrazioni MCP e AI audit per startup e PMI — con modelli come Claude, GPT e Gemini, senza lock-in di piattaforma.
- 🌐 Sito: [aicircus.it](https://aicircus.it) · [English](https://aicircus.it/en)
- 🧩 Servizi: [Servizi AI](https://aicircus.it/servizi) · [Consulenza AI in Italia](https://aicircus.it/consulenza-ai)
- 📝 Blog: [aicircus.it/blog](https://aicircus.it/blog)
- 🏛️ Gruppo: [ShadApps](https://www.shadapps.it) · [AppSviluppo](https://www.appsviluppo.com)
Se vuoi portare MCP e agenti AI dentro i tuoi processi, [parti da un AI Audit gratuito](https://aicircus.it/servizi).
## Licenza
[MIT](LICENSE) — usa, modifica e costruici sopra liberamente.
