Vectora

io.github.brunosrz由 GitHub 账号 brunosrz 发布v0.1.0rc3更新于 Oct 24, 2026

AI assistant with RAG, web search, filesystem and memory. MCP sub-agent for Claude Code.

已验证STDIO仅桌面网页搜索与抓取文件与存储知识与记忆

概览

AI 生成的概览

一个自托管的 AI 助手 MCP 子代理，为 Claude Code 增加 RAG、网页搜索、文件系统访问和记忆能力。

可以做什么
Vectora 是面向 Claude Code 的本地 MCP 子代理，结合了检索增强生成（RAG）、网页搜索与 URL 提取、文件系统访问以及记忆功能。它属于一个以原生安装包（而非容器）分发的自托管 AI 助手应用。清单未列出具体工具，因此这里无法说明确切的工具范围。
适用场景
当你希望助手基于自己的文档和记忆来回答、进行网页搜索，并在 Claude Code 中访问本地文件时，值得添加。它适合愿意自行运行基于 Python 的自托管助手，并自备模型与搜索 API 密钥的用户。
运行要求
以 PyPI 包 vectora-agent 通过 stdio 在本地运行，需要 Python 运行时。必需密钥：COHERE_API_KEY（用于 RAG 嵌入与重排序）和 TAVILY_API_KEY（用于网页搜索与 URL 提取）。可选密钥：GOOGLE_API_KEY（推荐的免费额度 LLM）、ANTHROPIC_API_KEY、OPENAI_API_KEY、LANGSMITH_API_KEY。仅限桌面端，无网页可执行版本。
安装前请注意
它要求多个第三方 API 密钥（COHERE_API_KEY、TAVILY_API_KEY、GOOGLE_API_KEY、ANTHROPIC_API_KEY、OPENAI_API_KEY、LANGSMITH_API_KEY），这些密钥会发送给各自的提供商，使用可能产生费用。文件系统访问意味着助手可以读取或修改本地文件，网页搜索与 URL 提取会把查询和网址发送给 Tavily。该项目为专有软件，且仅支持桌面端。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Vectora，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

Vectora — Monorepo

Monorepo da Vectora. Cada produto vive em sua própria pasta, com toolchain e lockfile independentes. O que conecta tudo é o GitHub Actions (um workflow por projeto, gated por path) e o pre-commit compartilhado na raiz.

Estrutura

PastaProjetoStackDeploy
vectora/App Vectora (assistente de IA self-hosted)Python (uv) + Vite + ElectronInstaladores nativos (Nuitka + Electron) via canal de update
company/Site institucionalTanStack Start + Vite (pnpm)Vercel → vectora.company
docs/DocumentaçãoHugoVercel → docs.vectora.company
services/Gateway (OAuth/webhooks pro desktop, ex-relay) + updates (distribuição de releases) — era relay/ + update-server/, unificadosHono + Cloudflare Workers (pnpm)Cloudflare (wrangler)

O app em si (backend Python, frontend Vite, casca Electron) fica todo dentro de vectora/ — veja vectora/README.md para detalhes de arquitetura, build e CLI.

CI/CD (.github/workflows/)

4 workflows reais, cada um gated por path (on.push/pull_request.paths): uma mudança só no vectora/ não dispara o build/deploy de company/docs/services.

WorkflowDispara emFaz
vectora.ymlvectora/**, tags v*lint • security • build • testes (unit/integration/e2e) • release nativo (Nuitka + Electron) • publica no canal de update (R2 + KV)
edge.ymlcompany/**, services/**, docs/**lint/typecheck/test dos 3 projetos • deploy automático em push em master (Vercel + Cloudflare)
release-please.ymlpush em mastermantém o PR de release acumulado (Conventional Commits) — mesclar publica a tag vX.Y.Z
pr-checks.ymlpull requestslabels automáticos • valida título em Conventional Commits

Não existe workflow de Docker Build/Push, CodeQL nem triage de issues — a distribuição do app vectora é via instaladores nativos (não imagem Docker).

Secrets esperados

SecretUsado por
GOOGLE_API_KEY, COHERE_API_KEY, TAVILY_API_KEY, LLM_PROVIDER, LOG_LEVELtestes do vectora
WIN_CERTIFICATE_BASE64, WIN_CERTIFICATE_PASSWORD, APPLE_ID, APPLE_APP_SPECIFIC_PASSWORD, APPLE_TEAM_ID, VECTORA_RELEASES_TOKENassinatura/publicação dos instaladores nativos
VERCEL_TOKEN, VERCEL_ORG_ID, VERCEL_PROJECT_ID_COMPANY, VERCEL_PROJECT_ID_DOCSdeploy Vercel (company + docs)
CLOUDFLARE_API_TOKEN, CLOUDFLARE_ACCOUNT_ID, R2_ACCESS_KEY_ID, R2_SECRET_ACCESS_KEYdeploy do services + canal de update (R2)

Desenvolvimento

Cada projeto é independente — entre na pasta e use o gerenciador dele:

bash
# App Vectora (Python + Vite + Electron)cd vectora && uv sync && uv run vectora start
# Site institucionalcd company && pnpm install && pnpm dev
# Docs (Hugo)cd docs && hugo server
# Services (gateway + updates)cd services && pnpm install && pnpm dev

Pre-commit (raiz)

O .pre-commit-config.yaml na raiz cobre todos os projetos (ruff/ty/bandit no vectora/, prettier/oxlint/tsc no frontend, actionlint nos workflows):

bash
pre-commit installpre-commit run --all-files

Licença

Proprietária. Consulte LICENSE.

来源：README.md，提交 bcdc09d

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v0.1.0rc3最新Sep 16, 2026

评分

已满足适用检查项的 40%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

    请在仓库或注册中心条目中声明许可证。