ravelry-mcp

Ein MCP-Server, der Claude mit der Ravelry-API verbindet und es Strickenden und Häkelnden ermöglicht, nach Mustern zu suchen, Garn zu finden und zu berechnen, wie viel sie kaufen müssen — und das über natürliche Sprache, ohne ihren Arbeitsablauf zu verlassen.

Werkzeuge

Related MCP server: agent-skill-loader

Voraussetzungen

• Python 3.11+

• uv

• Ein Ravelry-Entwicklerkonto mit einer persönlichen App (für die Anmeldedaten von Basic Auth)

Einrichtung

git clone https://github.com/alicegetmanchuk/ravelry-mcp-project.git ravelry-mcp
cd ravelry-mcp
uv pip install -e .
cp .env.example .env

Bearbeite .env mit deinen Ravelry-Anmeldedaten:

RAVELRY_USERNAME=your_username
RAVELRY_PASSWORD=your_personal_auth_token

Hinweis: v0 benötigt nur Lesezugriff über Basic Auth. Gehe auf Ravelry zu Pro → Apps → Erstelle eine persönliche App — das gibt dir einen Benutzernamen- und Passwort-Token ohne OAuth-Einrichtung.

Claude Desktop

Füge zu deiner claude_desktop_config.json hinzu:

{
  "mcpServers": {
    "ravelry": {
      "command": "uv",
      "args": ["run", "ravelry-mcp"],
      "cwd": "/path/to/ravelry-mcp"
    }
  }
}

Entwicklung

Führe den MCP inspector aus, um die Werkzeuge interaktiv zu testen:

uv run mcp dev src/ravelry_mcp/server.py:mcp

Fahrplan

Die folgenden Funktionen erfordern OAuth (Zugriff auf Benutzerebene) anstelle von Basic Auth:

• Stash-Abgleich — die Garnvorräte eines Benutzers mit den Anforderungen eines Musters abgleichen

• Zugriff auf die Warteschlange — die Muster-Warteschlange eines Benutzers lesen und verwalten

• Projektfortschritts-Tracker — laufende Strickprojekte protokollieren und aktualisieren