Scryfall MCP Server

Un server MCP (Model Context Protocol) per cercare e recuperare informazioni sulle carte di Magic: The Gathering tramite l'API di Scryfall.

🎯 Caratteristiche

• Ricerca carte: Cerca carte utilizzando la sintassi di ricerca di Scryfall
• Recupero carte specifiche: Ottieni dettagli su carte specifiche per nome
• Autocompletamento: Suggerimenti di nomi di carte basati su query parziali
• Preset di campi: Set predefiniti di campi per casi d'uso comuni
• Formati multipli: Supporto per output in formato JSON, CSV e tabella
• Rate limiting automatico: Gestione automatica dei limiti di rate dell'API Scryfall

📋 Prerequisiti

• Node.js (versione 18 o superiore)
• npm o yarn

🚀 Installazione

1. Clona o scarica questo repository
2. Installa le dipendenze:

npm install

⚙️ Configurazione

Configurazione in Claude Desktop

Aggiungi la seguente configurazione al file di configurazione di Claude Desktop:

Windows: %APPDATA%\Claude\claude_desktop_config.json macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "scryfall": {
      "command": "node",
      "args": ["C:\\path_to\\MCP_scryfall\\index.js"]
    }
  }
}

Importante: Sostituisci C:\\path_to\\MCP_scryfall\\ con il percorso assoluto dove hai clonato questo repository.

🔧 Strumenti Disponibili

1. search_cards

Cerca carte Magic: The Gathering utilizzando la sintassi di ricerca di Scryfall.

Parametri:

• query (obbligatorio): Query di ricerca Scryfall (es. 'c:red t:legendary', 'set:dom', 'o:flying cmc<=3')
• fields (opzionale): Lista di campi da includere nei risultati
• preset (opzionale): Usa un preset di campi predefinito ('basic', 'creatures', 'prices', 'commander', 'collection', 'comprehensive')
• order (opzionale): Ordinamento dei risultati ('name', 'set', 'released', 'rarity', 'color', 'usd', ecc.)
• unique (opzionale): Strategia per omettere carte simili ('cards', 'art', 'prints')
• format (opzionale): Formato di output ('json', 'csv', 'table')
• limit (opzionale): Numero massimo di carte da restituire

Esempio:

Cerca tutte le creature leggendarie rosse ordinate per nome

2. get_card

Ottieni una carta specifica per nome esatto, opzionalmente da un set specifico.

Parametri:

• name (obbligatorio): Nome esatto della carta
• set (opzionale): Codice del set (es. 'dom', 'war')
• fields (opzionale): Lista di campi da includere
• preset (opzionale): Usa un preset di campi predefinito
• format (opzionale): Formato di output ('json', 'table')

Esempio:

Mostrami i dettagli di "Lightning Bolt"

3. autocomplete

Ottieni suggerimenti di autocompletamento per nomi di carte.

Parametri:

• query (obbligatorio): Nome parziale della carta

Esempio:

Suggerisci nomi di carte che iniziano con "Black Lot"

4. get_field_presets

Mostra informazioni sui preset di campi disponibili.

Esempio:

Quali preset di campi sono disponibili?

📊 Preset di Campi

basic

name, set, rarity, type_line, mana_cost

creatures

name, set, type_line, mana_cost, power, toughness, rarity

prices

name, set, rarity, prices.usd, prices.usd_foil, prices.eur, prices.tix

commander

name, type_line, color_identity, cmc, rarity, edhrec_rank, prices.usd

collection

name, set_name, set, collector_number, rarity, artist, released_at

comprehensive

name, mana_cost, cmc, type_line, oracle_text, power, toughness, colors, color_identity, set, set_name, rarity, artist, prices.usd, legalities.standard, legalities.commander, scryfall_uri

🔍 Sintassi di Ricerca Scryfall

Per Colore

• c:red - Carte rosse
• c:wr - Carte bianche e rosse
• c>=bug - Almeno blu, nero e verde
• c:c - Carte incolori

Per Tipo

• t:creature - Creature
• t:instant - Istantanei
• t:legendary - Carte leggendarie
• t:"legendary creature" - Creature leggendarie

Per Set

• set:dom - Dominaria (usa il codice del set)
• set:war - War of the Spark

Per Rarità

• r:mythic - Mitico raro
• r:rare - Raro
• r:uncommon - Non comune
• r:common - Comune

Per Testo

• o:"draw a card" - Carte che contengono "draw a card"
• o:flying - Carte con volare

Per Costo di Mana

• cmc=3 - Costo di mana convertito esattamente 3
• cmc<=2 - CMC 2 o meno
• mv>=5 - Valore di mana 5 o più

Per Forza/Costituzione

• pow>=5 - Forza 5 o maggiore
• tou<=2 - Costituzione 2 o meno
• pow=tou - Forza uguale a costituzione

Per Formato

• f:standard - Legale in Standard
• f:commander - Legale in Commander
• f:modern - Legale in Modern

Combinazioni

c:blue t:creature cmc<=2 f:standard

"Creature blu con CMC 2 o meno che sono legali in Standard"

💡 Esempi di Utilizzo

Esempio 1: Cerca creature leggendarie rosse

Cerca carte con query "c:red t:legendary t:creature" usando il preset creatures in formato tabella

Esempio 2: Ottieni prezzi delle carte di un set

Cerca carte del set "mom" usando il preset prices in formato CSV

Esempio 3: Trova contromagie in Standard

Cerca "o:counter o:target o:spell f:standard" con campi personalizzati: name, set, mana_cost, oracle_text, rarity, prices.usd

Esempio 4: Informazioni su una carta specifica

Mostrami "Black Lotus" con il preset comprehensive

🛠️ Sviluppo

Per eseguire il server in modalità sviluppo:

npm start

📚 Risorse

• Documentazione API Scryfall
• Guida alla Sintassi di Ricerca Scryfall
• Riferimento Oggetto Carta
• Model Context Protocol

📄 Licenza

MIT

⚠️ Note

Questo server utilizza l'API di Scryfall, che è fornita gratuitamente per uso non commerciale. Si prega di rivedere i Termini dell'API di Scryfall prima di utilizzare questo server commercialmente.

Il server implementa automaticamente il rate limiting (100ms tra le richieste) per rispettare le linee guida dell'API di Scryfall.