/ 目录 / 演练场 / Weaviate Claude Skills
● 社区 saskinosie 🔑 需要你的密钥

Weaviate Claude Skills

作者 saskinosie · saskinosie/weaviate-claude-skills

端到端的本地Weaviate from Claude —设置、连接、架构、摄取和RAG五项重点技能。

saskinosie/weaviate-claude-skills是一个由五种技能组成的小型市场,涵盖Weaviate工作流程: weaviate-local-setup ( docker-compose )、weaviate-connection (健康检查+身份验证)、weaviate-collection-manager (架构和集合管理员)、weaviate-data-ingestion (单个+批量+文件导入)和weaviate-query-agent (语义搜索、过滤器、混合、RAG )。适用于Claude.ai和Claude Desktop ;您将带来文档库和技能处理矢量数据库管道。

为什么要用

核心特性

实时演示

实际使用效果

weaviate-claude-skills.replay ▶ 就绪
0/0

安装

选择你的客户端

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

打开 Claude Desktop → Settings → Developer → Edit Config。保存后重启应用。

~/.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 使用与 Claude Desktop 相同的 mcpServers 格式。项目级配置优先于全局。

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

点击 Cline 侧栏中的 MCP Servers 图标,然后选 "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
    }
  }
}

格式与 Claude Desktop 相同。重启 Windsurf 生效。

~/.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 使用服务器对象数组,而非映射。

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

加入 context_servers。Zed 保存后热重载。

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

一行命令搞定。用 claude mcp list 验证,claude mcp remove 卸载。

使用场景

实战用法: Weaviate Claude Skills

在1小时内为您的文档抹上当地的破布

👤 开发人员启动本地RAG原型 ⏱ ~60 min intermediate

何时使用: 您希望在不将文档发送给云供应商的情况下与自己的文档聊天。

前置条件
  • Docker + Python 3.10 + — 安装Docker Desktop ;如果需要,安装pyenv
  • 已安装技能 — git克隆到~/.claude/skills/
步骤
  1. Docker-start Weaviate
    使用weaviate-local-setup为本地Weaviate启动docker-compose。✓ 已复制
    → docker ps在8080上显示weaviate healthy
  2. 建立收藏
    使用字段创建集合“Docs” : title (text)、body (text)、source_url (text)。✓ 已复制
    → 已应用架构; weaviate-collection-manager返回配置
  3. 上传
    将./docs下的每个.md文件作为“Docs”中的对象导入。✓ 已复制
    → 已报告批处理进度;对象通过查询可见
  4. 發問
    使用weaviate-query-agent: '我们如何轮换API密钥?'✓ 已复制
    → Answer引用了文档集合中的source_url

结果: 您可以迭代的可运行的本地抹布。

注意事项
  • 导入整个巨型PDF ,无需分块 — 分块约500个代币;让技能的摄取模板处理它
搭配使用: filesystem

无需手动API调用即可迭代集合架构

👤 优化矢量架构的团队 ⏱ ~20 min intermediate

何时使用: 早期RAG —您的架构每周更改一次,您不需要curl命令。

步骤
  1. 检查当前架构
    显示“文档”的架构—字段,矢量化程序,索引配置。✓ 已复制
    → 已返回完整配置
  2. 提出变更
    添加“language”枚举属性( en/zh/ja ) ;保留其余部分。✓ 已复制
    → 迁移计划+备份警告
  3. 确认
    应用;重新索引现有的500个对象。✓ 已复制
    → 作业进度;计数对账

结果: 架构在意识到重新索引成本的情况下安全地发展。

注意事项
  • 假设房源移除是免费的 — 某些更改需要重新嵌入;技能标记便宜与昂贵

混合搜索+过滤器,提供可靠答案

👤 任何人都可以将抹布运送给真实用户 ⏱ ~15 min intermediate

何时使用: 纯语义搜索丢失了完全匹配的术语;混合( BM25 +向量)修复了它。

步骤
  1. 运行混合查询
    查询“SAML SSO错误代码42” , alpha = 0.5 (平衡语义+关键字)。✓ 已复制
    → 热门歌曲包括字面上的“42”匹配,但也包括与概念相关的匹配
  2. 图层过滤器
    筛选语言= 'en' , source_url包含'/docs/auth/'。✓ 已复制
    → 点击量缩小;答案仍被引用

结果: 精确术语查询的精确度更高,而不会丢失召回率。

搭配使用: local-rag

组合

与其他 MCP 搭配,撬动十倍杠杆

weaviate-claude-skills + filesystem

通过文件系统MCP导入本地文件,然后通过技能查询

列出./docs下的所有扣分项,导入Weaviate “Docs” ,然后混合搜索问题。✓ 已复制
weaviate-claude-skills + local-rag

比较方法—仅嵌入与Weaviate的结构化指数

对于此语料库,请在10个评估问题上对比local-rag和Weaviate混合语料库。✓ 已复制
weaviate-claude-skills + qdrant

评估工作负载上的矢量数据库选择

在Weaviate和Qdrant上运行相同的eval集;报告延迟+ MRR。✓ 已复制

工具

此 MCP 暴露的能力

工具输入参数何时调用成本
weaviate-local-setup (SKILL) (none) 仅限第一次—带出本地Weaviate 0
weaviate-connection (SKILL) URL + API key 验证可访问性和身份验证 0
weaviate-collection-manager (SKILL) schema ops 创建、检查或改进集合 0
weaviate-data-ingestion (SKILL) object(s) or file paths 单次插入、批量插入或文件导入 0
weaviate-query-agent (SKILL) query + filters + alpha 语义/混合搜索和RAG答案 0

成本与限制

运行它的成本

API 配额
无— Weaviate在本地运行
每次调用 Token 数
查询+检索到的区块大小
费用
本地免费。如果您以后迁移, Weaviate Cloud有自己的定价。
提示
故意分块(约500个代币) ;超大块浪费存储和上下文。

安全

权限、密钥、影响范围

凭据存储: 在.env中编织API密钥,而不是在技能文件中。本地开发人员可以跳过身份验证,但不会暴露端口。
数据出站: 没有任何东西离开您的机器进行本地设置。Cloud Weaviate发送到您配置的端点。

故障排查

常见错误与修复

连接被拒绝

Weaviate容器未运行。docker在weaviate-local-setup中compose up -d。

验证: curl localhost:8080/v1/.well-known/ready
架构更改失败

某些属性更改需要重新创建集合。导出、丢弃、重新创建、重新添加。

验证: weaviate-collection-manager diff output
缓慢查询

检查HNSW索引参数,并确保矢量化器配置正确。避免在未索引的字段上进行全文回退。

验证: Query explain in the skill's debug mode

替代方案

Weaviate Claude Skills 对比其他方案

替代方案何时用它替代权衡
qdrant您更喜欢Qdrant的API和Rust性能不同的SDK ;相似的功能
local-rag你想要一个没有矢量数据库的轻量本地抹布灵活性较差;无架构
neo4j您的数据是关系型/图形型,而不是矢量型不同型号

更多

资源

📖 阅读 GitHub 上的官方 README

🐙 查看未解决的 issue

🔍 浏览全部 400+ MCP 服务器和 Skills