/ Directory / Playground / Weaviate Claude Skills
← All servers ↗ GitHub
● Community saskinosie 🔑 Needs your key

Weaviate Claude Skills

by saskinosie · saskinosie/weaviate-claude-skills

End-to-end local Weaviate from Claude — setup, connect, schema, ingest, and RAG in five focused skills.

saskinosie/weaviate-claude-skills is a small marketplace of five skills covering the Weaviate workflow: weaviate-local-setup (docker-compose), weaviate-connection (health check + auth), weaviate-collection-manager (schema and collection admin), weaviate-data-ingestion (single + batch + file imports), and weaviate-query-agent (semantic search, filters, hybrid, RAG). Works with Claude.ai and Claude Desktop; you bring the vault of docs and the skills handle vector DB plumbing.

▶ Watch demo 📦 Install 💡 Use Cases

Why use it

Key features

Live Demo

What it looks like in practice

weaviate-claude-skills.replay ▶ ready
0/0

Install

Pick your client

~/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
    }
  }
}

Open Claude Desktop → Settings → Developer → Edit Config. Restart after saving.

~/.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 uses the same mcpServers schema as Claude Desktop. Project config wins over 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
    }
  }
}

Click the MCP Servers icon in the Cline sidebar, then "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
    }
  }
}

Same shape as Claude Desktop. Restart Windsurf to pick up changes.

~/.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 uses an array of server objects rather than a map.

~/.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"
        ]
      }
    }
  }
}

Add to context_servers. Zed hot-reloads on save.

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

One-liner. Verify with claude mcp list. Remove with claude mcp remove.

Use Cases

Real-world ways to use Weaviate Claude Skills

Stand up a local RAG over your docs in under an hour

👤 Developers starting a local RAG prototype ⏱ ~60 min intermediate

When to use: You want to chat with your own docs without sending them to a cloud vendor.

Prerequisites
  • Docker + Python 3.10+ — Install Docker Desktop; pyenv if needed
  • Skills installed — git clone into ~/.claude/skills/
Flow
  1. Docker-start Weaviate
    Use weaviate-local-setup to start docker-compose for a local Weaviate.✓ Copied
    → docker ps shows weaviate healthy on 8080
  2. Create a collection
    Create a collection 'Docs' with fields: title(text), body(text), source_url(text).✓ Copied
    → Schema applied; weaviate-collection-manager returns config
  3. Ingest
    Ingest every .md under ./docs as objects in 'Docs'.✓ Copied
    → Batch progress reported; objects visible via query
  4. Ask
    Use weaviate-query-agent: 'How do we rotate API keys?'✓ Copied
    → Answer cites source_url from the Docs collection

Outcome: A runnable local RAG you can iterate on.

Pitfalls
  • Ingesting giant PDFs whole without chunking — Chunk at ~500 tokens; let the skill's ingestion template handle it
Combine with: filesystem

Iterate a collection schema without manual API calls

👤 Teams refining their vector schema ⏱ ~20 min intermediate

When to use: Early RAG — your schema changes weekly and you don't want curl commands.

Flow
  1. Inspect current schema
    Show the schema for 'Docs' — fields, vectorizer, index config.✓ Copied
    → Full config returned
  2. Propose a change
    Add a 'language' enum property (en/zh/ja); keep the rest.✓ Copied
    → Migration plan + backup caveat
  3. Apply
    Apply; reindex the existing 500 objects.✓ Copied
    → Job progresses; counts reconcile

Outcome: Schema evolved safely with awareness of reindex cost.

Pitfalls
  • Assuming property removals are free — Some changes require re-embedding; the skill flags when it's cheap vs expensive

Hybrid search + filter for reliable answers

👤 Anyone shipping RAG to real users ⏱ ~15 min intermediate

When to use: Pure semantic search misses exact-match terms; hybrid (BM25 + vector) fixes it.

Flow
  1. Run hybrid queries
    Query 'SAML SSO error code 42', alpha=0.5 (balance semantic + keyword).✓ Copied
    → Top hits include the literal '42' match but also conceptually related ones
  2. Layer filters
    Filter language='en' and source_url contains '/docs/auth/'.✓ Copied
    → Hits narrowed; answer stays cited

Outcome: Higher precision on exact-term queries without losing recall.

Combine with: local-rag

Combinations

Pair with other MCPs for X10 leverage

weaviate-claude-skills + filesystem

Ingest local files via filesystem MCP, then query through the skill

List all markdown under ./docs, ingest into Weaviate 'Docs', then hybrid-search for the question.✓ Copied
weaviate-claude-skills + local-rag

Compare approaches — embeddings-only vs Weaviate's structured index

For this corpus, benchmark local-rag vs Weaviate hybrid on 10 eval questions.✓ Copied
weaviate-claude-skills + qdrant

Evaluate the vector DB choice on your workload

Run the same eval set on Weaviate and Qdrant; report latency + MRR.✓ Copied

Tools

What this MCP exposes

ToolInputsWhen to callCost
weaviate-local-setup (SKILL) (none) First time only — brings up local Weaviate 0
weaviate-connection (SKILL) URL + API key Verify reachability and auth 0
weaviate-collection-manager (SKILL) schema ops Create, inspect, or evolve a collection 0
weaviate-data-ingestion (SKILL) object(s) or file paths Single insert, batch insert, or file import 0
weaviate-query-agent (SKILL) query + filters + alpha Semantic / hybrid search and RAG answers 0

Cost & Limits

What this costs to run

API quota
None — Weaviate runs locally
Tokens per call
Query + retrieved chunk size
Monetary
Free for local. Weaviate Cloud has its own pricing if you migrate later.
Tip
Chunk intentionally (~500 tokens); oversize chunks waste both storage and context.

Security

Permissions, secrets, blast radius

Credential storage: Weaviate API keys in .env, not in skill files. Local dev can skip auth but don't expose the port.
Data egress: Nothing leaves your machine for local setup. Cloud Weaviate sends to your configured endpoint.

Troubleshooting

Common errors and fixes

Connection refused 8080

Weaviate container not running. docker compose up -d in weaviate-local-setup.

Verify: curl localhost:8080/v1/.well-known/ready
Schema change fails

Some property changes require collection recreate. Export, drop, recreate, re-ingest.

Verify: weaviate-collection-manager diff output
Slow queries

Check HNSW index parameters and that vectorizer is properly configured. Avoid full-text fallback on unindexed fields.

Verify: Query explain in the skill's debug mode

Alternatives

Weaviate Claude Skills vs others

AlternativeWhen to use it insteadTradeoff
qdrantYou prefer Qdrant's API and Rust performanceDifferent SDK; similar capabilities
local-ragYou want a lightweight local RAG without a vector DBLess flexible; no schema
neo4jYour data is relational/graph, not vectorDifferent model

More

Resources

📖 Read the official README on GitHub

🐙 Browse open issues

🔍 Browse all 400+ MCP servers and Skills