mcpField
V
vectora

vectora

ローカル
github.com/brunosrzAI・エージェント1今日更新
リポジトリ

vectora について

Vectoraは、RAG、ウェブ検索、ファイルシステムへのアクセス、メモリ機能を備えたセルフホスト型AIアシスタントアプリです。このモノレポには、アプリのほか、企業サイト、ドキュメント、ゲートウェイ、更新サービスが含まれます。

主な機能

  1. 01セルフホスト型AIアシスタントアプリ
  2. 02RAG、ウェブ検索、メモリ
  3. 03ファイルシステムへのアクセス
  4. 04PythonバックエンドとVite、Electron
  5. 05ネイティブインストーラーと更新チャネル

活用シーン

  1. 01セルフホスト環境でのAIアシスタント運用
  2. 02ウェブやローカルファイルをコンテキストに利用
  3. 03ネイティブアプリのビルドと配布

MCP 対応

タグラインではClaude Code向けMCPサブエージェントとされていますが、READMEにはMCP機能の説明がありません。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
  "mcpServers": {
    "brunosrz-vectora": {
      "command": "uvx",
      "args": [
        "vectora-agent"
      ],
      "env": {
        "GOOGLE_API_KEY": "<GOOGLE_API_KEY>",
        "COHERE_API_KEY": "<COHERE_API_KEY>",
        "TAVILY_API_KEY": "<TAVILY_API_KEY>",
        "OPENAI_API_KEY": "<OPENAI_API_KEY>",
        "ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>",
        "LANGSMITH_API_KEY": "<LANGSMITH_API_KEY>"
      }
    }
  }
}
起動コマンドuvx vectora-agent
設定が必要な環境変数
GOOGLE_API_KEYシークレットGoogle Gemini API key (recommended free-tier LLM provider)
COHERE_API_KEYシークレットCohere API key — required for RAG embeddings and reranking
TAVILY_API_KEYシークレットTavily API key — required for web search and URL extraction
OPENAI_API_KEYシークレットOpenAI API key (optional — alternative LLM provider)
ANTHROPIC_API_KEYシークレットAnthropic API key (optional — alternative LLM provider)
LANGSMITH_API_KEYシークレットLangSmith API key (optional — tracing and observability)

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
pypivectora-agent0.1.0rc3

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

Vectora — モノレポ

Vectora のモノレポです。各プロダクトはそれぞれ独立したツールチェーンと ロックファイルを持つフォルダーに格納されています。すべてをつなぐのは GitHub Actions（プロジェクトごとにパスでゲートされたワークフロー）と、ルートで 共有される pre-commit です。

構成

フォルダープロジェクトスタックデプロイ
vectora/Vectora アプリ（セルフホスト可能な AI アシスタント）Python (uv) + Vite + Electronネイティブインストーラー（Nuitka + Electron）を更新チャネル経由で配布
company/企業サイトTanStack Start + Vite (pnpm)Vercel → vectora.company
docs/ドキュメントHugoVercel → docs.vectora.company
services/ゲートウェイ（デスクトップ向け OAuth／webhook、旧 relay）＋アップデート（リリース配布） — 旧 relay/ ＋ update-server/ を統合Hono + Cloudflare Workers (pnpm)Cloudflare (wrangler)

アプリ本体（Python バックエンド、Vite フロントエンド、Electron シェル）はすべて vectora/ 内にあります。アーキテクチャ、ビルド、CLI の詳細については、 vectora/README.md をご覧ください。

CI/CD (.github/workflows/)

実際に動作するワークフローは 4 つあり、それぞれパスでゲートされています （on.push/pull_request.paths）。vectora/ のみの変更では、 company／docs／services のビルドやデプロイは実行されません。

ワークフロー実行条件内容
vectora.ymlvectora/**、タグ v*lint • セキュリティ • ビルド • テスト（ユニット／統合／e2e） • ネイティブリリース（Nuitka + Electron） • 更新チャネル（R2 + KV）への公開
edge.ymlcompany/**、services/**、docs/**3 プロジェクトの lint／typecheck／test • master への push 時に自動デプロイ（Vercel + Cloudflare）
release-please.ymlmaster への pushリリース用 PR の内容を累積（Conventional Commits） — マージするとタグ vX.Y.Z を公開します
pr-checks.ymlpull requestラベルの自動付与 • Conventional Commits に沿ったタイトルの検証

Docker Build／Push、CodeQL、issue トリアージのワークフローはありません。vectora アプリは Docker イメージではなく、ネイティブインストーラーで配布されます。

期待されるシークレット
シークレット使用箇所
GOOGLE_API_KEY, COHERE_API_KEY, TAVILY_API_KEY, LLM_PROVIDER, LOG_LEVELvectora のテスト
WIN_CERTIFICATE_BASE64, WIN_CERTIFICATE_PASSWORD, APPLE_ID, APPLE_APP_SPECIFIC_PASSWORD, APPLE_TEAM_ID, VECTORA_RELEASES_TOKENネイティブインストーラーの署名／公開
VERCEL_TOKEN, VERCEL_ORG_ID, VERCEL_PROJECT_ID_COMPANY, VERCEL_PROJECT_ID_DOCSVercel のデプロイ（company + docs）
CLOUDFLARE_API_TOKEN, CLOUDFLARE_ACCOUNT_ID, R2_ACCESS_KEY_ID, R2_SECRET_ACCESS_KEYservices のデプロイ + 更新チャネル（R2）

開発

各プロジェクトは独立しています。フォルダーに移動し、それぞれのパッケージマネージャーを使用してください。

# App Vectora (Python + Vite + Electron)
cd vectora && uv sync && uv run vectora start

# Site institucional
cd company && pnpm install && pnpm dev

# Docs (Hugo)
cd docs && hugo server

# Services (gateway + updates)
cd services && pnpm install && pnpm dev
Pre-commit（ルート）

ルートの .pre-commit-config.yaml はすべてのプロジェクトを対象としています（vectora/ の ruff/ty/bandit、フロントエンドの prettier/oxlint/tsc、ワークフローの actionlint）。

pre-commit install
pre-commit run --all-files

ライセンス

プロプライエタリです。LICENSE をご覧ください。

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。