Weaviate Claude Skills MCP — Casos de uso, Instalar & Demo en vivo

Por qué usarlo

Características clave

Cinco habilidades que cubren el ciclo de vida local completo de Weaviate
Plantilla de composición de Docker para una instancia local
Ingestión por lotes e importaciones basadas en archivos
Consultas RAG con filtros, búsqueda híbrida y análisis
Configuración de Python-venv con requisitos.txt

Demo en vivo

Cómo se ve en la práctica

weaviate-claude-skills.replay ▶ listo

0/0

Instalar

Elige tu cliente

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

{
  "mcpServers": {
    "weaviate-claude-skills": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/saskinosie/weaviate-claude-skills",
        "~/.claude/skills/weaviate-claude-skills"
      ],
      "_inferred": true
    }
  }
}

Abre Claude Desktop → Settings → Developer → Edit Config. Reinicia después de guardar.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "weaviate-claude-skills": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/saskinosie/weaviate-claude-skills",
        "~/.claude/skills/weaviate-claude-skills"
      ],
      "_inferred": true
    }
  }
}

Cursor usa el mismo esquema mcpServers que Claude Desktop. La configuración del proyecto prevalece sobre la global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "weaviate-claude-skills": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/saskinosie/weaviate-claude-skills",
        "~/.claude/skills/weaviate-claude-skills"
      ],
      "_inferred": true
    }
  }
}

Haz clic en el icono MCP Servers de la barra lateral de Cline y luego en "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "weaviate-claude-skills": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/saskinosie/weaviate-claude-skills",
        "~/.claude/skills/weaviate-claude-skills"
      ],
      "_inferred": true
    }
  }
}

Mismo formato que Claude Desktop. Reinicia Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "weaviate-claude-skills",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/saskinosie/weaviate-claude-skills",
        "~/.claude/skills/weaviate-claude-skills"
      ]
    }
  ]
}

Continue usa un array de objetos de servidor en lugar de un mapa.

~/.config/zed/settings.json

{
  "context_servers": {
    "weaviate-claude-skills": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/saskinosie/weaviate-claude-skills",
          "~/.claude/skills/weaviate-claude-skills"
        ]
      }
    }
  }
}

Añádelo a context_servers. Zed recarga en caliente al guardar.

claude mcp add weaviate-claude-skills -- git clone https://github.com/saskinosie/weaviate-claude-skills ~/.claude/skills/weaviate-claude-skills

Un solo comando. Verifica con claude mcp list. Quita con claude mcp remove.

Casos de uso

Usos del mundo real: Weaviate Claude Skills

Instale un RAG local sobre sus documentos en menos de una hora

👤 Desarrolladoras iniciando un prototipo RAG local ⏱ ~60 min intermediate

Cuándo usarlo: Quiere chatear con sus propios documentos sin enviarlos a un proveedor de nube.

Requisitos previos

Docker + Python 3.10+ — Instale el escritorio Docker; pyenv si es necesario
Habilidades instaladas — git clonar en ~/.claude/skills/

Flujo

Weaviate de inicio de Docker

Utilice weaviate-local-setup para iniciar docker-compose para un Weaviate local.✓ Copiado

→ Docker PS muestra Weaviate saludable en 8080
Crear una colección

Cree una colección 'Documentos' con campos: título (texto), cuerpo (texto), source_url (texto).✓ Copiado

→ Esquema aplicado; weaviate-collection-manager devuelve la configuración
Ingerir

Ingiere cada .md en ./docs como objetos en 'Documentos'.✓ Copiado

→ Se informa el progreso del lote; objetos visibles mediante consulta
Preguntar

Utilice weaviate-query-agent: '¿Cómo rotamos las claves API?'✓ Copiado

→ La respuesta cita source_url de la colección Docs

Resultado: Un RAG local ejecutable sobre el que puedes iterar.

Errores comunes

Ingerir archivos PDF gigantes completos sin fragmentarlos — Fragmento en ~500 tokens; deja que la plantilla de ingesta de la habilidad se encargue de ello

Combinar con: filesystem

Iterar un esquema de colección sin llamadas API manuales

👤 Equipos refinando su esquema vectorial ⏱ ~20 min intermediate

Cuándo usarlo: Early RAG: su esquema cambia semanalmente y no desea comandos curl.

Flujo

Inspeccionar el esquema actual

Muestre el esquema para 'Documentos': campos, vectorizador, configuración de índice.✓ Copiado

→ Configuración completa devuelta
proponer un cambio

Agregue una propiedad de enumeración de 'idioma' (en/zh/ja); quédate con el resto.✓ Copiado

→ Plan de migración + advertencia de copia de seguridad
Aplicar

Aplicar; reindexar los 500 objetos existentes.✓ Copiado

→ El trabajo avanza; los recuentos se reconcilian

Resultado: El esquema evolucionó de forma segura con conocimiento del costo de reindexación.

Errores comunes

Suponiendo que las mudanzas de propiedades sean gratuitas — Algunos cambios requieren volver a incrustarse; la habilidad flaquea cuando es barato versus caro

Búsqueda híbrida + filtro para respuestas confiables

👤 Cualquiera que envíe RAG a usuarios reales ⏱ ~15 min intermediate

Cuándo usarlo: La búsqueda semántica pura omite términos de coincidencia exacta; El híbrido (BM25 + vector) lo soluciona.

Flujo

Ejecutar consultas híbridas

Consulta 'Código de error 42 de SAML SSO', alfa = 0,5 (equilibrio semántico + palabra clave).✓ Copiado

→ Los principales éxitos incluyen la coincidencia literal '42' pero también otras relacionadas conceptualmente.
Filtros de capa

Filter language='en' y source_url contiene '/docs/auth/'.✓ Copiado

→ Los hits se redujeron; la respuesta permanece citada

Resultado: Mayor precisión en consultas de términos exactos sin perder recuerdo.

Combinar con: local-rag

Combinaciones

Combínalo con otros MCPs para multiplicar por 10

weaviate-claude-skills + filesystem

Ingerir archivos locales a través del sistema de archivos MCP y luego consultar a través de la habilidad

Enumere todas las rebajas en ./docs, ingiera en Weaviate 'Docs' y luego realice una búsqueda híbrida de la pregunta.✓ Copiado

weaviate-claude-skills + local-rag

Comparar enfoques: solo incorporaciones frente al índice estructurado de Weaviate

Para este corpus, compare el híbrido local-rag vs Weaviate en 10 preguntas de evaluación.✓ Copiado

weaviate-claude-skills + qdrant

Evalúe la elección de base de datos vectorial en su carga de trabajo

Ejecute el mismo conjunto de evaluación en Weaviate y Qdrant; informar latencia + MRR.✓ Copiado

Herramientas

Lo que expone este MCP

Herramienta	Entradas	Cuándo llamar
weaviate-local-setup (SKILL)	(none)	Solo la primera vez: menciona Weaviate local
weaviate-connection (SKILL)	URL + API key	Verificar la accesibilidad y la autenticación
weaviate-collection-manager (SKILL)	schema ops	Crear, inspeccionar o evolucionar una colección
weaviate-data-ingestion (SKILL)	object(s) or file paths	Inserción única, inserción por lotes o importación de archivos
weaviate-query-agent (SKILL)	query + filters + alpha	Búsqueda semántica/híbrida y respuestas RAG

Coste y límites

Lo que cuesta ejecutarlo

Cuota de API: Ninguna - Weaviate corre localmente
Tokens por llamada: Consulta + tamaño de fragmento recuperado
Monetario: Gratis para locales. Weaviate Cloud tiene su propio precio si migras más tarde.
Consejo: Fragmentar intencionalmente (~500 tokens); Los trozos de gran tamaño desperdician tanto almacenamiento como contexto.

Seguridad

Permisos, secretos, alcance

Almacenamiento de credenciales: Weaviate claves API en .env, no en archivos de habilidades. El desarrollador local puede omitir la autenticación pero no exponer el puerto.

Salida de datos: Nada sale de su máquina para la configuración local. Cloud Weaviate envía a su punto final configurado.

Weaviate local vinculado a 0.0.0.0 de forma predeterminada en muchas imágenes; restrinja a 127.0.0.1 si se ejecutan otros servicios en su LAN.
Incrustar modelos: si utiliza un vectorizador de terceros, sus fragmentos van a ese proveedor. Manténgalo local (por ejemplo, text2vec-transformers) para datos confidenciales.

Resolución de problemas

Errores comunes y soluciones

Conexión rechazada 8080

El contenedor Weaviate no funciona. Docker compone -d en weaviate-local-setup.

Verificar: curl localhost:8080/v1/.well-known/ready

El cambio de esquema falla

Algunos cambios de propiedad requieren que se vuelva a crear la colección. Exporte, suelte, vuelva a crear y vuelva a ingerir.

Verificar: weaviate-collection-manager diff output

consultas lentas

Verifique los parámetros del índice HNSW y que el vectorizador esté configurado correctamente. Evite recurrir al texto completo en campos no indexados.

Verificar: Query explain in the skill's debug mode

Alternativas

Weaviate Claude Skills vs otros

Alternativa	Cuándo usarla	Contrapartida
qdrant	Prefieres la API de Qdrant y el rendimiento de Rust	SDK diferente; capacidades similares
local-rag	Quieres un RAG local liviano sin una base de datos vectorial	Menos flexible; sin esquema
neo4j	Sus datos son relacionales/gráficos, no vectoriales	modelo diferente

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills