Iniziare con AnythingMCP

Cos'è AnythingMCP?

AnythingMCP è un gateway open-source che trasforma le tue API REST, SOAP, GraphQL e i tuoi database in server MCP (Model Context Protocol). Una volta collegati, puoi interagire con i tuoi sistemi attraverso agenti AI come Claude, ChatGPT, Copilot o qualsiasi client compatibile con MCP.

Prerequisiti

• Docker e Docker Compose — Installa Docker
• Git — per clonare il repository
• Un terminale — bash su macOS o Linux

Per lo sviluppo locale senza Docker (opzionale):

• Node.js 22+
• npm

Avvio rapido

1. Clonare il repository

git clone https://github.com/HelpCode-ai/anythingmcp.git
cd anythingmcp

2. Eseguire lo script di configurazione

bash setup.sh

La procedura guidata interattiva ti accompagna attraverso l'intera configurazione:

Passaggio 1 — Modalità di distribuzione Scegli tra Docker (consigliato per la produzione) o sviluppo locale.

Passaggio 2 — Dominio e porte Inserisci il tuo hostname. Per l'uso locale, mantieni il valore predefinito localhost. Per la produzione, inserisci il tuo dominio (es. mcp.example.com) e lo script configurerà Caddy come reverse proxy con SSL automatico Let's Encrypt.

Passaggio 3 — Segreti Tutte le credenziali di sicurezza vengono generate automaticamente:

• Segreto JWT per l'autenticazione
• Chiave di crittografia per i dati sensibili
• Password del database
• Segreto NextAuth

Passaggio 4 — Autenticazione MCP Scegli come gli agenti AI si autenticano con il tuo endpoint MCP:

• OAuth 2.0 (consigliato)
• Chiave API / Token Bearer (legacy)
• Entrambi (OAuth + fallback legacy)
• Nessuno (solo sviluppo)

Passaggio 5 — Email (opzionale) Configura SMTP per la verifica degli utenti, gli inviti e la reimpostazione della password.

Passaggio 6 — Redis (opzionale) Abilita Redis per la limitazione della frequenza e il caching delle risposte.

Lo script genera il file .env, configura Docker Compose e avvia tutti i servizi automaticamente.

3. Aprire la dashboard

Una volta completata la configurazione, apri la dashboard:

• Locale: http://localhost:3000
• Con dominio: https://mcp.example.com

Registra il tuo account amministratore — il primo utente a registrarsi diventa l'amministratore.

Collegare la tua prima API

1. Accedi alla dashboard
2. Clicca su Create Connector
3. Scegli il tipo di connettore (REST, SOAP, GraphQL o Database)
4. Configura la connessione (importa le specifiche OpenAPI, WSDL o inserisci le credenziali del database)
5. Salva e attiva

Il tuo endpoint MCP è pronto su:

http://localhost:4000/mcp

Collegare un agente AI

Aggiungi il tuo server MCP a qualsiasi client AI compatibile. Esempio per Claude Desktop (oppure aggiungi l'URL del server direttamente in Claude.ai → Connectors):

{
  "mcpServers": {
    "my-server": {
      "url": "http://localhost:4000/mcp"
    }
  }
}

Architettura

AnythingMCP funziona come un singolo container con due servizi:

Servizi aggiuntivi:

• PostgreSQL 17 — memorizza connettori, utenti e configurazione
• Caddy (opzionale) — reverse proxy con SSL automatico
• Redis (opzionale) — limitazione della frequenza e caching delle risposte

Comandi comuni

# Visualizzare i log
docker compose logs -f

# Riavviare i servizi
docker compose restart

# Fermare i servizi
docker compose down

# Aggiornare all'ultima versione
git pull && docker compose up -d --build

Passaggi successivi

• Cos'è MCP? — Comprendere il Model Context Protocol
• REST API a MCP — Collega la tua prima API REST
• Database a MCP — Collega i database direttamente
• Distribuire su Hetzner — Distribuzione in produzione con SSL
• Distribuire su AWS — Distribuisci su EC2