Spines

Name: Spines
Author: GetSpines

von GetSpinesVersion 1.1.0i★ 0iLäuft auf deinem Computer

Name in der Registryio.github.SuperAgentic/spines

So installierst du es

What it does

Access book collections, reading lists, and bookshelf recognition from AI assistants.

Connects Läuft auf deinem Computer
Account or key Needs SPINES_API_KEY
Category Sonstiges

Installation

Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.

2/3 Prüfungen bestanden · Läuft auf deinem Computer · ✓ Befehle geprüft am 13. Nov. 2026

Zuerst: Welche KI nutzt du?

ClaudeWeb · App · HandyChatGPTWebClaude CodeTerminalCursorCode-EditorVS CodeCode-EditorAndereAndere Apps

Wähle deine App, dann erscheinen die Schritte unten.

Klappt mit Claude, aber erst etwas vorbereiten

Du brauchst einen Schlüssel von Spines (auf der Seite des Anbieters erstellen) · Installiere zuerst Node.js auf deinem Computer (nur einmal) · Nur in der Claude-App für den Computer (Windows oder Mac), nicht im Web oder auf dem Handy

Von der KI installieren lassen

Kopiere diese Nachricht in einen Claude-Chat. Die KI prüft deinen Rechner, sagt dir, welche Datei sie ändert, und wartet jedes Mal auf dein OK.

Installiere bitte den MCP server Spines für Claude auf diesem Rechner, in dieser Reihenfolge: 1) Prüfe Node.js mit node -v. Fehlt es, sag mir, dass ich es von https://nodejs.org/en/download installiere; installiere es nicht selbst. 2) Verwende nur diese Konfiguration (von PopNx MCP geprüft): { "mcpServers": { "spines": { "command": "npx", "args": [ "-y", "@spines/mcp-server" ], "env": { "SPINES_API_KEY": "your-value" } } } } 3) Nenne mir den vollständigen Pfad der Datei, die du änderst, oder den Befehl, den du ausführst, und warte auf mein OK. 4) Lass bei SPINES_API_KEY "your-value" stehen und sag mir, dass ich den echten Wert selbst in die Datei oder das Feld der App einfüge. Bitte mich nie, einen Schlüssel in den Chat zu schreiben. 5) Führe das Vereinbarte aus und prüfe, dass die Tools von Spines wirklich erscheinen.

Diese Nachricht enthält keinen Schlüssel. Wird einer gebraucht, bittet dich die KI, ihn selbst in die Datei oder das Feld der App einzufügen.

1
Node.js installieren (falls noch nicht vorhanden)
Schon installiert? Zuerst prüfen · Öffne das Terminal, gib diesen Befehl ein und drücke Enter
node -v
- Eine Versionsnummer wie v26.13.1 = installiert, diesen Schritt überspringen
- "command not found" (unter Windows "is not recognized") = noch nicht installiert, oder gerade installiert und das Terminal muss neu geöffnet werden
So öffnest du das Terminal
Mac: ⌘ + Leertaste drücken, Terminal eingeben, Enter
Windows: Start öffnen, Windows PowerShell eingeben, dann Öffnen
Noch nicht installiert: Öffne die offizielle Download-Seite, wähle die LTS-Version und den Klick-Installer: .pkg auf dem Mac · .msi unter Windows. Doppelklicken und bis zum Ende durchklicken. Kein curl-Befehl nötig
Download-Seite von Node.js öffnen ↗
Danach das Terminal schließen, neu öffnen und denselben Befehl erneut ausführen. Es muss eine Versionsnummer erscheinen: node -v
Einmal installieren, gilt für alles, was Node.js braucht
Erledigt
Bei Spines registrieren und Schlüssel erstellen
Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.
Wie du einen Schlüssel bekommst, steht unten im README des Anbieters
Erledigt
Einstellungsdatei der Claude-Desktop-App öffnen
SettingsDeveloperEdit Config
Erledigt

Diese Einstellungen einfügen und speichern

{
  "mcpServers": {
    "spines": {
      "command": "npx",
      "args": [
        "-y",
        "@spines/mcp-server"
      ],
      "env": {
        "SPINES_API_KEY": "your-value"
      }
    }
  }
}

Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem

Erledigt

Claude beenden und neu öffnen
Erledigt
Ausprobieren
Nutze Spines und sag mir, was du für mich tun kannst; zeig mir dann eine Sache
✓ Wenn Claude sagt, dass es Spines nutzt, oder ein Werkzeug von Spines in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

ChatGPT kann Spines noch nicht verbinden

Spines läuft auf deinem Computer, aber ChatGPT verbindet nur Server, die im Web laufen

Das kannst du stattdessen tun

A · Eine App nutzen, die Spines verbinden kann

Schritte für Claude →Du brauchst einen Schlüssel von Spines (auf der Seite des Anbieters erstellen) · Installiere zuerst Node.js auf deinem Computer (nur einmal) · Nur in der Claude-App für den Computer (Windows oder Mac), nicht im Web oder auf dem Handy
Schritte für Claude Code →Du brauchst einen Schlüssel von Spines (auf der Seite des Anbieters erstellen) · Installiere zuerst Node.js auf deinem Computer (nur einmal)
Schritte für Cursor →Du brauchst einen Schlüssel von Spines (auf der Seite des Anbieters erstellen) · Installiere zuerst Node.js auf deinem Computer (nur einmal)
Schritte für VS Code →Du brauchst einen Schlüssel von Spines (auf der Seite des Anbieters erstellen) · Installiere zuerst Node.js auf deinem Computer (nur einmal)

B · Andere in Sonstiges, die mit ChatGPT funktionieren

Aus den meistgenutzten derselben Kategorie, nur solche, die per Adresse ohne Schlüssel verbinden

Hostinger✓ ChatGPT
World Monitor✓ ChatGPT
Svelte MCP✓ ChatGPT

Klappt mit Claude Code, aber erst etwas vorbereiten

Du brauchst einen Schlüssel von Spines (auf der Seite des Anbieters erstellen) · Installiere zuerst Node.js auf deinem Computer (nur einmal)

Von der KI installieren lassen

Kopiere diese Nachricht in einen Claude Code-Chat. Die KI prüft deinen Rechner, sagt dir, welche Datei sie ändert, und wartet jedes Mal auf dein OK.

Installiere bitte den MCP server Spines für Claude Code auf diesem Rechner, in dieser Reihenfolge: 1) Prüfe Node.js mit node -v. Fehlt es, sag mir, dass ich es von https://nodejs.org/en/download installiere; installiere es nicht selbst. 2) Verwende nur diese Konfiguration (von PopNx MCP geprüft): claude mcp add --scope user spines --env SPINES_API_KEY=your-value -- npx -y @spines/mcp-server 3) Nenne mir den vollständigen Pfad der Datei, die du änderst, oder den Befehl, den du ausführst, und warte auf mein OK. 4) Lass bei SPINES_API_KEY "your-value" stehen und sag mir, dass ich den echten Wert selbst in die Datei oder das Feld der App einfüge. Bitte mich nie, einen Schlüssel in den Chat zu schreiben. 5) Führe das Vereinbarte aus und prüfe, dass die Tools von Spines wirklich erscheinen.

Diese Nachricht enthält keinen Schlüssel. Wird einer gebraucht, bittet dich die KI, ihn selbst in die Datei oder das Feld der App einzufügen.

1
Node.js installieren (falls noch nicht vorhanden)
Schon installiert? Zuerst prüfen · Öffne das Terminal, gib diesen Befehl ein und drücke Enter
node -v
- Eine Versionsnummer wie v26.13.1 = installiert, diesen Schritt überspringen
- "command not found" (unter Windows "is not recognized") = noch nicht installiert, oder gerade installiert und das Terminal muss neu geöffnet werden
So öffnest du das Terminal
Mac: ⌘ + Leertaste drücken, Terminal eingeben, Enter
Windows: Start öffnen, Windows PowerShell eingeben, dann Öffnen
Noch nicht installiert: Öffne die offizielle Download-Seite, wähle die LTS-Version und den Klick-Installer: .pkg auf dem Mac · .msi unter Windows. Doppelklicken und bis zum Ende durchklicken. Kein curl-Befehl nötig
Download-Seite von Node.js öffnen ↗
Danach das Terminal schließen, neu öffnen und denselben Befehl erneut ausführen. Es muss eine Versionsnummer erscheinen: node -v
Einmal installieren, gilt für alles, was Node.js braucht
Erledigt
Bei Spines registrieren und Schlüssel erstellen
Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.
Wie du einen Schlüssel bekommst, steht unten im README des Anbieters
Erledigt
Terminal öffnen
Mac: Command+Leertaste drücken und Terminal tippen · Windows: PowerShell öffnen
Erledigt
4
Diesen Befehl einfügen und Enter drücken
```
claude mcp add --scope user spines --env SPINES_API_KEY=your-value -- npx -y @spines/mcp-server
```
Ersetze „your-value“ vor dem Enter durch deinen Schlüssel
Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem
Erledigt
/mcp in Claude Code eingeben
Spines sollte in der Liste als verbunden erscheinen
Erledigt
Ausprobieren
Nutze Spines und sag mir, was du für mich tun kannst; zeig mir dann eine Sache
✓ Wenn Claude Code sagt, dass es Spines nutzt, oder ein Werkzeug von Spines in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit Cursor, aber erst etwas vorbereiten

Du brauchst einen Schlüssel von Spines (auf der Seite des Anbieters erstellen) · Installiere zuerst Node.js auf deinem Computer (nur einmal)

Von der KI installieren lassen

Kopiere diese Nachricht in einen Cursor-Chat. Die KI prüft deinen Rechner, sagt dir, welche Datei sie ändert, und wartet jedes Mal auf dein OK.

Installiere bitte den MCP server Spines für Cursor auf diesem Rechner, in dieser Reihenfolge: 1) Prüfe Node.js mit node -v. Fehlt es, sag mir, dass ich es von https://nodejs.org/en/download installiere; installiere es nicht selbst. 2) Verwende nur diese Konfiguration (von PopNx MCP geprüft): { "mcpServers": { "spines": { "command": "npx", "args": [ "-y", "@spines/mcp-server" ], "env": { "SPINES_API_KEY": "your-value" } } } } 3) Nenne mir den vollständigen Pfad der Datei, die du änderst, oder den Befehl, den du ausführst, und warte auf mein OK. 4) Lass bei SPINES_API_KEY "your-value" stehen und sag mir, dass ich den echten Wert selbst in die Datei oder das Feld der App einfüge. Bitte mich nie, einen Schlüssel in den Chat zu schreiben. 5) Führe das Vereinbarte aus und prüfe, dass die Tools von Spines wirklich erscheinen.

Diese Nachricht enthält keinen Schlüssel. Wird einer gebraucht, bittet dich die KI, ihn selbst in die Datei oder das Feld der App einzufügen.

1
Node.js installieren (falls noch nicht vorhanden)
Schon installiert? Zuerst prüfen · Öffne das Terminal, gib diesen Befehl ein und drücke Enter
node -v
- Eine Versionsnummer wie v26.13.1 = installiert, diesen Schritt überspringen
- "command not found" (unter Windows "is not recognized") = noch nicht installiert, oder gerade installiert und das Terminal muss neu geöffnet werden
So öffnest du das Terminal
Mac: ⌘ + Leertaste drücken, Terminal eingeben, Enter
Windows: Start öffnen, Windows PowerShell eingeben, dann Öffnen
Noch nicht installiert: Öffne die offizielle Download-Seite, wähle die LTS-Version und den Klick-Installer: .pkg auf dem Mac · .msi unter Windows. Doppelklicken und bis zum Ende durchklicken. Kein curl-Befehl nötig
Download-Seite von Node.js öffnen ↗
Danach das Terminal schließen, neu öffnen und denselben Befehl erneut ausführen. Es muss eine Versionsnummer erscheinen: node -v
Einmal installieren, gilt für alles, was Node.js braucht
Erledigt
Bei Spines registrieren und Schlüssel erstellen
Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.
Wie du einen Schlüssel bekommst, steht unten im README des Anbieters
Erledigt
Mit diesem Button Cursor öffnen
In Cursor öffnen
Cursor fragt nach einer Bestätigung; klicke Install
Erledigt
Schlüssel eintragen
In den Einstellungen von Spines ist SPINES_API_KEY leer; trag deinen Schlüssel ein und speichere
Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem
Erledigt
KI-Chat in Cursor im Agent-Modus öffnen
Erledigt
Ausprobieren
Nutze Spines und sag mir, was du für mich tun kannst; zeig mir dann eine Sache
✓ Wenn Cursor sagt, dass es Spines nutzt, oder ein Werkzeug von Spines in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Cursor abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit VS Code, aber erst etwas vorbereiten

Du brauchst einen Schlüssel von Spines (auf der Seite des Anbieters erstellen) · Installiere zuerst Node.js auf deinem Computer (nur einmal)

Von der KI installieren lassen

Kopiere diese Nachricht in einen VS Code-Chat. Die KI prüft deinen Rechner, sagt dir, welche Datei sie ändert, und wartet jedes Mal auf dein OK.

Installiere bitte den MCP server Spines für VS Code auf diesem Rechner, in dieser Reihenfolge: 1) Prüfe Node.js mit node -v. Fehlt es, sag mir, dass ich es von https://nodejs.org/en/download installiere; installiere es nicht selbst. 2) Verwende nur diese Konfiguration (von PopNx MCP geprüft): { "servers": { "spines": { "type": "stdio", "command": "npx", "args": [ "-y", "@spines/mcp-server" ], "env": { "SPINES_API_KEY": "your-value" } } } } 3) Nenne mir den vollständigen Pfad der Datei, die du änderst, oder den Befehl, den du ausführst, und warte auf mein OK. 4) Lass bei SPINES_API_KEY "your-value" stehen und sag mir, dass ich den echten Wert selbst in die Datei oder das Feld der App einfüge. Bitte mich nie, einen Schlüssel in den Chat zu schreiben. 5) Führe das Vereinbarte aus und prüfe, dass die Tools von Spines wirklich erscheinen.

Diese Nachricht enthält keinen Schlüssel. Wird einer gebraucht, bittet dich die KI, ihn selbst in die Datei oder das Feld der App einzufügen.

1
Node.js installieren (falls noch nicht vorhanden)
Schon installiert? Zuerst prüfen · Öffne das Terminal, gib diesen Befehl ein und drücke Enter
node -v
- Eine Versionsnummer wie v26.13.1 = installiert, diesen Schritt überspringen
- "command not found" (unter Windows "is not recognized") = noch nicht installiert, oder gerade installiert und das Terminal muss neu geöffnet werden
So öffnest du das Terminal
Mac: ⌘ + Leertaste drücken, Terminal eingeben, Enter
Windows: Start öffnen, Windows PowerShell eingeben, dann Öffnen
Noch nicht installiert: Öffne die offizielle Download-Seite, wähle die LTS-Version und den Klick-Installer: .pkg auf dem Mac · .msi unter Windows. Doppelklicken und bis zum Ende durchklicken. Kein curl-Befehl nötig
Download-Seite von Node.js öffnen ↗
Danach das Terminal schließen, neu öffnen und denselben Befehl erneut ausführen. Es muss eine Versionsnummer erscheinen: node -v
Einmal installieren, gilt für alles, was Node.js braucht
Erledigt
Bei Spines registrieren und Schlüssel erstellen
Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.
Wie du einen Schlüssel bekommst, steht unten im README des Anbieters
Erledigt
Mit diesem Button VS Code öffnen
In VS Code öffnen
VS Code fragt nach einer Bestätigung; klicke Install
Erledigt
Schlüssel eintragen
In den Einstellungen von Spines ist SPINES_API_KEY leer; trag deinen Schlüssel ein und speichere
Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem
Erledigt
KI-Chat in VS Code im Agent-Modus öffnen
Erledigt
Ausprobieren
Nutze Spines und sag mir, was du für mich tun kannst; zeig mir dann eine Sache
✓ Wenn VS Code sagt, dass es Spines nutzt, oder ein Werkzeug von Spines in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von VS Code abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Andere Apps mit MCP, etwa Windsurf, Zed oder Gemini CLI, fügen Server unterschiedlich hinzu. Sieh in der App-Liste nach

Alle Apps mit MCP ansehen →

JSON-Einstellungen stehen unten unter „Für Entwickler“

Hängst du fest? Frag Leute, die Spines nutzen💬 Diskussion →

Für Entwickler: Terminal-Befehle und JSON-Einstellungen

Auf deinem Computer installiert

Claude Code

claude mcp add --scope user spines --env SPINES_API_KEY=your-value -- npx -y @spines/mcp-server

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "spines": {
      "command": "npx",
      "args": [
        "-y",
        "@spines/mcp-server"
      ],
      "env": {
        "SPINES_API_KEY": "your-value"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "spines": {
      "command": "npx",
      "args": [
        "-y",
        "@spines/mcp-server"
      ],
      "env": {
        "SPINES_API_KEY": "your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "spines": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@spines/mcp-server"
      ],
      "env": {
        "SPINES_API_KEY": "your-value"
      }
    }
  }
}

Werte, die du selbst einträgst

SPINES_API_KEY geheim erforderlich env
Your SPINES API key

Die Beschreibungen sind noch im englischen Original.

Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.

Auf einen Blick

GitHub-Sterne i: 0
Downloads pro Wochei: 58/Wo.
Lizenz i: MIT
Verbindung: Läuft auf deinem Computer
Transport: stdio
Neueste Versioni: 1.1.0
Kategoriei: Sonstiges
In der Registry veröffentlichti: 15. Okt. 2026
Code zuletzt geänderti: 15. Okt. 2026
Entwickler: GetSpines
Pakete: npm: @spines/mcp-server
Repo: GetSpines/mcp-server
Registry-Status: Aktiv

Welche Apps ihn nutzen können

Basierend darauf, wie sich dieser Server verbindet, und auf der eigenen Doku jeder App, geprüft am 10. Nov. 2026.

Laufen auf deinem Computer in

Claude Goose LM Studio Msty Studio Cherry Studio Cursor VS Code + GitHub Copilot Visual Studio Windsurf (Devin Desktop)Zed Kiro Cline Continue JetBrains AI Assistant Claude Code Codex CLI Gemini CLI OpenCode nodecode Warp LibreChat Raycast

Alle Apps, mit Vor- und Nachteilen →

Was er kann

Läuft auf deinem Computer; die Tool-Liste erscheint nach der Installation in deiner KI-App.

Basischecksi

Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 15. Nov. 2026

! Vorsicht
Entwickler passt zum Repo
Der Herausgeber (SuperAgentic) ist nicht der Repo-Inhaber (GetSpines); vielleicht hat jemand anderes ihn eingetragen
✓ Bestanden
Wird noch gepflegt
Code zuletzt geändert: vor 31 Tagen
✓ Bestanden
Hat eine Lizenz
Nutzt MIT
– Nicht zutreffend
Endpunkt antwortet
Dieser Server läuft auf deinem Computer; es gibt keinen Endpunkt im Internet
– Nicht zutreffend
Anmeldung mit OAuth
Läuft auf deinem Computer und nutzt stattdessen lokale Einstellungen
… Noch nicht geprüft
Keine versteckten Anweisungen in Tool-Beschreibungen
Läuft auf deinem Computer; Tool-Listen können wir nur von Endpunkten im Internet lesen

Veröffentlichte Schwachstellen (OSV.dev)

Noch nicht geprüft

Was wir prüfen → · JSON

Entwickler: neue Prüfung anfordern oder falsche Angaben melden

Anmelden

Diskussion

Fragen, Tipps teilen oder melden, dass etwas nicht geht. Sortiert nach „hilfreich“.

Noch keine Beiträge. Stell die erste Frage oder teile einen Tipp.

Beiträge hier stammen von Nutzern, nicht vom PopNx-Team.

Anmelden, um zu posten

Nutzerbewertungen

Noch keine Bewertungen

Anmelden, um eine Bewertung zu schreiben

Im Vergleich mit anderen in Sonstigesi

Mehr Sterne als 0 % der anderen 19886 Server in dieser Kategorie
Neuer in der Registry veröffentlicht als 58 % der anderen 19886 Server in dieser Kategorie
Basischecks gleich gut wie oder besser als bei 45 % der anderen 19886 Server in dieser Kategorie

Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.

Häufige Fragen

Ist Spines sicher?

Er hat 2 von 3 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.

Welche Schlüssel oder Codes braucht er?

Das musst du eintragen: SPINES_API_KEY

Läuft er auf meinem Computer oder in der Cloud?

Er läuft auf deinem Computer. Deine KI-App startet ihn bei Bedarf, und die Daten laufen nicht über die Server des Entwicklers (außer der Server ruft selbst einen Onlinedienst auf).

Wird er noch gepflegt?

Das GitHub-Repo wurde zuletzt vor 31 Tagen geändert, und die neueste Version (1.1.0) kam vor 31 Tagen in die Registry.

Welche Apps können ihn nutzen?

Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Außerdem brauchst du Node.js auf deinem Computer.

Was kann ich stattdessen nutzen?

In derselben Kategorie: World Monitor, openstatus, Oh My Posh Validator, Strata, Jitsu

README vom Entwickler

README öffnen

Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.

SPINES MCP Server

Access SPINES book collections, reading lists, and bookshelf data from AI assistants via the Model Context Protocol.

Features

Recognize books from photos of a bookshelf; several photos of one shelf become one collection
Search books by title, author, or ISBN
Browse and filter book collections
Manage reading lists (add and remove books)
Explore personas, categories, and books commonly shelved together
AI prompts for shelf analysis and book recommendations

Quick Start

Prerequisites

Node.js 18+
A SPINES API key (get one here)

Installation

npm install -g @spines/mcp-server

Configuration

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

"mcpServers": { "spines": { "command": "npx", "args": ["-y", "@spines/mcp-server"], "env": { "SPINES_API_KEY": "gtspn_live_your_key_here" } } } }

VS Code / Cursor

Add to your MCP settings:

"spines": { "command": "npx", "args": ["-y", "@spines/mcp-server"], "env": { "SPINES_API_KEY": "gtspn_live_your_key_here" } } }

Environment Variables

Variable	Required	Default	Description
`SPINES_API_KEY`	Yes	-	Your API key
`SPINES_API_URL`	No	`https://getspines.com/api/v1`	API base URL
`SPINES_DEBUG`	No	`false`	Verbose logging to stderr
`SPINES_LLM_PROVIDER`	No	-	Bring your own LLM key for `recognize_bookshelf`; only `gemini` is accepted. Set together with `SPINES_LLM_API_KEY`
`SPINES_LLM_API_KEY`	No	-	Your provider API key. With both set, recognition uses your key and no SPINES credits

Tools

Read Tools

Tool	Description
`search_books`	Search for books by title, author, or ISBN
`get_book_details`	Get full details for a specific book
`get_collection`	Get a book collection with all its books
`list_collections`	List your collections with optional filters
`list_categories`	List all approved book categories
`get_persona`	Get details about a persona
`get_book_pairings`	Find books commonly shelved together with a book (Shelfology)
`check_credits`	Check your daily recognition credit balance

Write Tools

Tool	Description
`add_to_reading_list`	Add a book to a reading list
`remove_from_reading_list`	Remove a book from a reading list
`recognize_bookshelf`	Recognize books from one or more bookshelf photos and save them as a collection (uses credits)

Tool Details

`search_books`

query: string    - Search query (title, author, or ISBN)

limit?: number - Max results (1-50, default 10)

`get_book_details`

book_id: string  - The book's unique ID

`get_collection`

collection_id: string  - The collection's unique ID

`list_collections`

limit?: number        - Max results (1-50, default 20)

cursor?: string - Pagination cursor persona_id?: string - Filter by persona category_id?: string - Filter by category

`list_categories`

(no arguments)

`get_persona`

persona_id: string  - The persona's unique ID

`get_book_pairings`

book_id: string  - The book to find pairings for

limit?: number - Max results (1-50, default 10)

`check_credits`

(no arguments)

`add_to_reading_list`

book_id: string      - The book to add

list_name?: string - List name (default: "want_to_read")

`remove_from_reading_list`

entry_id: string     - The reading list entry ID to remove

`recognize_bookshelf`

image_url?: string     - URL of a single photo

image_base64?: string - Base64-encoded single photo images?: array - Several photos of one bookshelf, saved as ONE collection; each entry is { image_url } or { image_base64 } cover_index?: number - Zero-based index into images of the cover photo (default 0) title?: string - Title for the new collection

Send either image_url / image_base64 or images, not both. Example:

"images": [ { "image_url": "https://example.com/shelf-left.jpg" }, { "image_url": "https://example.com/shelf-right.jpg" } ], "cover_index": 1, "title": "Living room" }

Photo limit: 4 per request with a regular key. A book that appears on two photos is kept once.
Credits: each photo uses one credit; the request needs at least one to start. With SPINES_LLM_PROVIDER / SPINES_LLM_API_KEY set, no credits are used.
Prefer URLs. Base64 photos over 4 MB in total do not fit in one request.
Duplicates: a photo already in SPINES fails the whole request (RECOGNIZE_IMAGE_DUPLICATE, with the index of that photo).
Timing: the tool waits while the server reads every photo, then polls until book matching finishes (up to 2 minutes). It returns the finished collection, or the job's current status (with its job_id) if matching is still running or its status could not be read. If the first step times out (5 minutes), the collection may still be created: check list_collections before trying again, since a retry uses credits again.

Resources

URI	Description
`spines://collection/{id}`	A book collection with metadata
`spines://book/{id}`	Full book details
`spines://persona/{id}`	Persona profile and collections
`spines://reading-lists`	User's reading lists

Prompts

Prompt	Description
`analyze_shelf`	Analyze a collection for themes and reading patterns
`recommend_books`	Get recommendations based on your library
`compare_collections`	Compare two collections for similarities

Troubleshooting

Problem	Solution
"SPINES_API_KEY is required"	Set the env var in your MCP client config
401 errors	Check your API key is valid and not expired
403 errors	Your key may lack required scopes
429 errors	Rate limited — wait and retry
`TIMEOUT` from `recognize_bookshelf`	The server may still be working; check `list_collections` before resending
Tools not appearing	Restart your MCP client

Development

git clone https://github.com/GetSpines/mcp-server

cd mcp-server npm install npm run build npm test

License

MIT

Spines

What it does

Installation

Node.js installieren (falls noch nicht vorhanden)

Bei Spines registrieren und Schlüssel erstellen

Einstellungsdatei der Claude-Desktop-App öffnen

Diese Einstellungen einfügen und speichern

Claude beenden und neu öffnen

Ausprobieren

Das kannst du stattdessen tun

Node.js installieren (falls noch nicht vorhanden)

Bei Spines registrieren und Schlüssel erstellen

Terminal öffnen

Diesen Befehl einfügen und Enter drücken

/mcp in Claude Code eingeben

Ausprobieren

Node.js installieren (falls noch nicht vorhanden)

Bei Spines registrieren und Schlüssel erstellen

Mit diesem Button Cursor öffnen

Schlüssel eintragen

KI-Chat in Cursor im Agent-Modus öffnen

Ausprobieren

Node.js installieren (falls noch nicht vorhanden)

Bei Spines registrieren und Schlüssel erstellen

Mit diesem Button VS Code öffnen

Schlüssel eintragen

KI-Chat in VS Code im Agent-Modus öffnen

Ausprobieren

Auf deinem Computer installiert

Werte, die du selbst einträgst

Auf einen Blick

Welche Apps ihn nutzen können

Was er kann

Basischecksi

Entwickler passt zum Repo

Wird noch gepflegt

Hat eine Lizenz

Endpunkt antwortet

Anmeldung mit OAuth

Keine versteckten Anweisungen in Tool-Beschreibungen

Veröffentlichte Schwachstellen (OSV.dev)

Diskussion

Nutzerbewertungen

Im Vergleich mit anderen in Sonstigesi

Häufige Fragen

Ähnliche Alternativen

World Monitor

openstatus

Oh My Posh Validator

Strata

Jitsu

README vom Entwickler

SPINES MCP Server

Features

Quick Start

Prerequisites

Installation

Configuration

Claude Desktop

VS Code / Cursor

Environment Variables

Tools

Read Tools

Write Tools

Tool Details

search_books

get_book_details

get_collection

list_collections

list_categories

get_persona

get_book_pairings

check_credits

add_to_reading_list

remove_from_reading_list

recognize_bookshelf

Resources

Prompts

Troubleshooting

Development

`search_books`

`get_book_details`

`get_collection`

`list_collections`

`list_categories`

`get_persona`

`get_book_pairings`

`check_credits`

`add_to_reading_list`

`remove_from_reading_list`

`recognize_bookshelf`