ravelry-mcp

Un servidor MCP que conecta a Claude con la API de Ravelry, lo que permite a tejedores y aficionados al crochet buscar patrones, encontrar lana y calcular cuánto comprar, todo mediante lenguaje natural sin salir de su flujo de trabajo.

Herramientas

Related MCP server: agent-skill-loader

Requisitos previos

• Python 3.11+

• uv

• Una cuenta de desarrollador de Ravelry con una aplicación personal (para credenciales de Basic Auth)

Configuración

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

Edita .env con tus credenciales de Ravelry:

RAVELRY_USERNAME=your_username
RAVELRY_PASSWORD=your_personal_auth_token

Nota: v0 solo necesita acceso de solo lectura de Basic Auth. En Ravelry, ve a Pro → Apps → Crear una aplicación personal; esto te proporciona un token de usuario y contraseña sin necesidad de configuración de OAuth.

Claude Desktop

Añade a tu claude_desktop_config.json:

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

Desarrollo

Ejecuta el inspector de MCP para probar las herramientas de forma interactiva:

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

Hoja de ruta

Las siguientes funciones requieren OAuth (acceso a nivel de usuario) en lugar de Basic Auth:

• Coincidencia de reservas de lana — buscar las reservas de lana de un usuario frente a los requisitos de un patrón

• Acceso a la cola — leer y gestionar la cola de patrones de un usuario

• Seguimiento de proyectos — registrar y actualizar proyectos de tejido en curso