🤖

Nanobot

Trasforma MCP Server in Agenti AI Ricchi

Framework open source MCP-native per costruire agenti intelligenti con ragionamento, system prompt, orchestrazione tool e UI interattiva.

Sito Ufficiale GitHub

🤖 Cos'è Nanobot?

Nanobot è un framework open source che funge da MCP Host standalone — ovvero il componente che combina MCP Server con un LLM e un contesto per creare un'esperienza agente completa.

Mentre applicazioni come VS Code, Claude, Cursor e ChatGPT includono un MCP Host integrato, Nanobot è progettato per essere un MCP Host indipendente, deployabile e integrabile nelle tue applicazioni. Con Nanobot puoi creare il tuo chatbot personalizzato alimentato da MCP e MCP-UI.

ℹ️ Stato del progetto: Nanobot è in sviluppo attivo (alpha). È sviluppato dal team di Obot.ai ed è rilasciato sotto licenza Apache 2.0. Aspettati cambiamenti architetturali significativi.

🌐 Cos'è un MCP Host?

Per capire Nanobot è fondamentale capire cos'è un MCP Host nell'architettura del Model Context Protocol:

🔧
MCP Server

Espone tool e risorse (es. un server che permette di giocare a blackjack, accedere a Hugging Face, gestire un e-commerce).

🧠
MCP Host (= Nanobot)

Combina MCP server + LLM + contesto per presentare un'esperienza agente all'utente finale (chat, voice, SMS, Slack, ecc.).

👤
Utente

Interagisce con l'agente tramite l'interfaccia esposta dal MCP Host (tipicamente una chat UI).

💡 Il punto chiave

In Nanobot ogni agente è a sua volta un MCP Server. Questo significa che puoi comporre agenti che usano altri agenti, creando catene e orchestrazioni sofisticate — tutto parlando MCP.

⚡ Funzionalità Principali

🔗

MCP-Native

Costruito attorno al protocollo MCP fin dal primo giorno. Ogni agente è un MCP Server che può essere consumato da altri agenti o applicazioni.

🎨

MCP-UI

Supporta MCP-UI: i tool possono restituire componenti React interattivi (giochi, dashboard, carrelli e-commerce) direttamente nella chat.

📝

Configurazione YAML

Definisci agenti, modelli e MCP server in un semplice file nanobot.yaml. Nessun codice necessario per iniziare.

🔌

Integrabile Ovunque

Nanobot può essere embedded in siti web, app, Slack, SMS, email e qualsiasi interfaccia che supporti la comunicazione con agenti.

🌍

Ecosistema MCP

Sfrutta l'ecosistema MCP in rapida crescita: migliaia di nuovi server vengono creati ogni mese, tutti compatibili con Nanobot.

🆓

Open Source

Completamente open source sotto licenza Apache 2.0. Scritto in Go (80%), Svelte (12%) e TypeScript (6%).

📦 Installazione

Nanobot si installa via Homebrew con un singolo comando:

Homebrew
brew install nanobot-ai/tap/nanobot

Questo ti fornisce la CLI nanobot per eseguire e gestire il tuo MCP Host.

Provider Supportati

Nanobot supporta i seguenti provider di modelli AI:

🟢
OpenAI

gpt-4, gpt-4.1, ecc.

🔵
Anthropic

claude-3, claude-3-7-sonnet, ecc.

Configurazione API Key
# Per modelli OpenAI
export OPENAI_API_KEY=sk-...

# Per modelli Anthropic
export ANTHROPIC_API_KEY=sk-ant-...

Nanobot seleziona automaticamente il provider corretto in base al modello specificato.

🚀 Primo Agente in 3 Passi

Creare il tuo primo agente Nanobot è semplicissimo:

1 Crea il file di configurazione
nanobot.yaml
agents:
  dealer:
    name: Blackjack Dealer
    model: gpt-4.1
    mcpServers: blackjackmcp

mcpServers:
  blackjackmcp:
    url: https://blackjack.nanobot.ai/mcp
2 Avvia Nanobot
Terminal
nanobot run ./nanobot.yaml
3 Apri la UI nel browser

Vai su http://localhost:8080 e inizia a interagire con il tuo agente!

📂 Configurazione Avanzata (Directory)

Oltre al file singolo nanobot.yaml, Nanobot supporta una configurazione basata su directory, dove ogni agente è definito in un file .md separato con front-matter YAML:

Struttura Directory
my-config/
├── agents/           # Definizioni agenti
│   ├── main.md       # Agente principale (auto-entrypoint)
│   └── helper.md      # Agente aggiuntivo
└── mcp-servers.yaml # Definizioni MCP server
Esempio File Agente
agents/main.md
---
name: Shopping Assistant
model: claude-3-7-sonnet-latest
mcpServers:
  - store
temperature: 0.7
---

You are a helpful shopping assistant.
Help users find products and answer
their questions.

Il front-matter YAML supporta tutti i campi di configurazione (model, name, mcpServers, tools, temperature, ecc.), mentre il body Markdown diventa le istruzioni (system prompt) dell'agente.

🎨 MCP-UI: Componenti Interattivi nella Chat

UI Interattiva dentro la Conversazione

Una delle caratteristiche più innovative di Nanobot è il supporto a MCP-UI: i tool MCP possono restituire componenti React interattivi che vengono renderizzati direttamente nella finestra di chat.

🃏
Giochi

Un tavolo da blackjack interattivo direttamente nella chat

📊
Dashboard

Grafici e visualizzazioni dati in tempo reale

🛒
E-commerce

Carrelli e cataloghi prodotti interattivi

💡 Perché è importante?

Con MCP-UI, un agente non è più limitato a risposte testuali. Può mostrare interfacce complesse, raccogliere input dall'utente tramite form e pulsanti, e creare esperienze ricche — tutto all'interno della stessa conversazione.

🎮 Esempi dal Vivo

Ecco alcuni Nanobot già funzionanti che puoi provare subito:

🃏 Blackjack Game

Un dealer di blackjack AI con interfaccia di gioco interattiva resa tramite MCP-UI.

Prova dal Vivo | Config
🤗 Hugging Face MCP

Un agente che si collega a Hugging Face per esplorare modelli, dataset e spazi della piattaforma.

Prova dal Vivo | Config
🛒 Shopping / Shopify

Un assistente shopping con catalogo prodotti e carrello interattivo dentro la chat.

Prova dal Vivo | Config

🗺️ Stato e Roadmap

Nanobot mira a essere un MCP Host pienamente conforme con supporto completo MCP + MCP-UI:

MCP Core
✅ Tool e risorse MCP
✅ Prompt MCP
🚧 Sampling MCP
✅ Multi-agent support
MCP-UI
✅ Componenti React nella chat
🚧 Rendering avanzato
❌ Theming personalizzato
Prossimamente
  • Piena conformità MCP + MCP-UI
  • Supporto multi-agente robusto
  • UI production-ready
  • Più provider di modelli
  • Autenticazione e sicurezza avanzata
  • Integrazioni frontend: Slack, SMS, email, agenti web embedded
  • Embedding semplificato in app e siti web

🌍 Community e Risorse

GitHub

930+ stelle, 131 fork, 12 contributor. Codice sorgente in Go, Svelte e TypeScript.

Vai al Repo

Discord

Community del progetto per supporto, feedback e discussioni.

Unisciti

Documentazione

Guide, esempi e riferimenti tecnici su docs.nanobot.ai.

Leggi i Docs

📋 Riepilogo

✅ Punti di Forza
  • Open source (Apache 2.0)
  • MCP-native: ogni agente è un MCP Server
  • MCP-UI: componenti React interattivi nella chat
  • Configurazione YAML semplice e immediata
  • Supporto OpenAI e Anthropic
  • UI web integrata (localhost:8080)
  • Embeddabile in qualsiasi applicazione
  • Composizione multi-agente
📌 Da Tenere a Mente
  • Progetto in alpha — aspettati breaking changes
  • Richiede Homebrew per l'installazione
  • API key OpenAI o Anthropic necessaria
  • UI ancora in sviluppo (non production-ready)
  • Documentazione in espansione
  • Supporto modelli limitato a OpenAI e Anthropic per ora

🤖 Pronto a Costruire il tuo Agente MCP?

Installa Nanobot, crea un file YAML e lancia il tuo primo agente AI alimentato dall'ecosistema MCP in pochi minuti.

Inizia su GitHub nanobot.ai