memory

Velixar MCP Server

AI アシスタント向けの、初の認知メモリサーバーです。ベクトルデータベースのラッパーではありません。あらゆるセッションを通じて、AI に永続的なメモリ、ナレッジグラフ、アイデンティティの認識、矛盾の検出、信念の追跡機能を提供する、完全な推論レイヤーです。

Model Context Protocol クライアントであれば、どれでも利用できます。Claude Desktop、Kiro、Cursor、Windsurf、Continue.dev、またはカスタムホストに対応しています。

このプロジェクトの目的

AI アシスタントは、会話のたびにゼロから始まります。Velixar はこれを解決します。ただし、テキストを保存して取得するだけではありません。この MCP サーバーにより、アシスタントは次のことができるようになります。

• 1 回の呼び出しでワークスペース内の状況を把握できます。コンテキストを手動で組み立てる必要はありません
• 信念が時間とともにどう変化するかを追跡し、矛盾が生じた際に提示できます
• 発見したエンティティや関係性のナレッジグラフを構築し、たどることができます
• あなたがどのような人か、何を好むか、どのように作業するかを示す永続的なアイデンティティモデルを維持できます
• 重複を排除しながら、セッションから自動的に長期保存可能なメモリを抽出できます
• バックアップや移行のために、メモリコーパス全体をインポートおよびエクスポートできます

40 個のツール。5 個のライブリソース。19 個のワークフロープロンプト。npm install 1 回で利用できます。

クイックスタート

npm install -g velixar-mcp-server

velixarai.com/settings/api-keys で API キーを取得し、MCP クライアントに追加します。

{
  "mcpServers": {
    "velixar": {
      "command": "velixar-mcp-server",
      "env": {
        "VELIXAR_API_KEY": "vlx_your_key_here"
      }
    }
  }
}

アシスタントを再起動すれば完了です。

ツール一覧

メモリ

ツール	機能
velixar_store	タグ、階層、種類を指定してメモリを保存します
velixar_search	すべてのメモリを対象にセマンティック検索します
velixar_list	ページネーションとフィルタリングを使って一覧を表示します
velixar_update	既存のメモリの内容やタグを編集します
velixar_delete	メモリを削除します

認知機能

ツール	機能
velixar_context	ワークスペースの概要を合成し、1 回の呼び出しで状況を把握できます
velixar_identity	ユーザーのプロフィール、好み、専門知識を取得、保存、更新します
velixar_contradictions	解決方法のガイダンスとともに、矛盾する事実や信念を提示します
velixar_timeline	トピックや信念が時間とともにどのように変化したかを示します
velixar_patterns	履歴全体から、繰り返し現れる問題と解決策のパターンを見つけます
velixar_inspect	完全な出所情報を含め、特定のメモリを詳細に調査します
velixar_graph_traverse	エンティティ間の関係をたどります。「X につながるものは何ですか？」
velixar_distill	重複を排除しながら、セッション内容から長期保存可能なメモリを抽出します

ライフサイクル

ツール	機能
velixar_session_save	後から呼び出せるようにセッションの概要を保存します
velixar_session_recall	前回のセッションからコンテキストを復元します
velixar_batch_store	1 回の呼び出しで最大 20 件のメモリを保存します
velixar_batch_search	最大 10 件の検索クエリを同時に実行します
velixar_consolidate	関連するメモリを、1 件の長期保存可能なメモリに統合します
velixar_retag	複数のメモリのタグを一括更新します
velixar_export	必要に応じてグラフデータも含め、メモリを JSON または Markdown としてエクスポートします
velixar_import	JSON、Markdown、Notion、Obsidian のエクスポートデータから一括インポートします

システム

ツール	機能
velixar_health	バックエンドの接続状況、レイテンシ、ワークスペースの状態を確認します
velixar_debug	キャッシュの状態、サーキットブレーカー、API の処理時間を確認します
velixar_capabilities	機能一覧、ツール一覧、リソース URI を確認します
velixar_security	コンテンツスキャンモードを取得または設定します

ライブリソース

リソースはアシスタントのコンテキストに自動的に挿入されるため、ツールの呼び出しは不要です。

リソース	提供される内容
velixar://system/constitution	アシスタントの行動規則と認知モード
velixar://identity/current	継続的に保持されるユーザープロファイル
velixar://memories/recent	直近のメモリ（簡易版）
velixar://memories/relevant	現在のアクティビティに基づく、文脈に関連したメモリ
velixar://domains/{domain}/shadow_graph	特定のドメインのナレッジグラフビュー

ワークフロープロンプト

複数ステップの推論ワークフローをガイドする、16 個の組み込みプロンプトです。

• オリエンテーション — 以前の推論を思い出し、プロジェクトのコンテキストを構築し、エンティティのプロフィールを作成し、全体像を把握してから対象を絞り込みます
• コンフリクト — 矛盾を解決し、ナレッジの不足を特定します
• 継続性 — 信念の変化をたどり、セッションを再開し、意思決定の道筋を再構築します
• ライフサイクル — セッションから要点を抽出し、トピックのメモリを統合し、直近のメモリにタグを付け直します
• アイデンティティ — ユーザーのアイデンティティを要約し、好みの変化を検出し、応答スタイルを調整します
• エンタープライズ — 特定のドメインにおけるエンタープライズへの適合性を評価します

ワークスペースの分離

メモリはワークスペースごとにスコープが設定されます。個人のプロジェクトが仕事に混入することはありません。

優先度	ソース	方法
1	VELIXAR_WORKSPACE_ID 環境変数	明示的
2	プロジェクトルートの .velixar.json	{ "workspace_id": "my-project" }
3	Git ルートディレクトリ名	自動

ホスト互換性

ホスト	ツール	リソース	プロンプト
Kiro CLI	✅	✅	✅
Claude Desktop	✅	✅	✅
Cursor	✅	⚠️	—
Windsurf	✅	⚠️	—
Continue.dev	✅	✅	✅

ホストがリソースやプロンプトに対応していない場合、サーバーは適切に機能を縮退します。すべてのツールは引き続き個別に動作します。

環境変数

変数	必須	説明
VELIXAR_API_KEY	はい	API キー（vlx_ で始まります）
VELIXAR_WORKSPACE_ID	いいえ	明示的なワークスペーススコープ
VELIXAR_API_URL	いいえ	カスタム API エンドポイント
VELIXAR_USER_ID	いいえ	明示的なエンドユーザー ID。未設定のままにしてください（推奨）。API はキーからスコープを導出するため、ダッシュボードと同様に、自分のメモリを確認できます。1 つのキーを複数の名前付きエンドユーザーで共有する場合にのみ設定してください
VELIXAR_DEBUG	いいえ	詳細なログを出力する場合は true
VELIXAR_LOG_FORMAT	いいえ	Datadog／CloudWatch の構造化ログには json
VELIXAR_HEALTH_PORT	いいえ	HTTP ヘルスチェックエンドポイントのポート

信頼性

• 指数バックオフによる自動再試行（3 回）
• サーキットブレーカー — 障害が継続すると開き、自動的に復旧します
• キャッシュへのフォールバック — 障害発生中は失敗する代わりに古いデータを提供します
• Datadog および CloudWatch と互換性のある構造化ログ

SDK

コードから Velixar を直接使用できます。

• JavaScript/TypeScript：npm install velixar — ドキュメント
• Python：pip install velixar — ドキュメント

CI/CD 統合

• GitHub Actions：velixar-memory-sync — PR のマージ内容からメモリを抽出します
• GitHub Actions：velixar-decision-capture — Issue の解決内容を意思決定として保存します
• Webhook：POST /webhook/ci — 汎用 CI イベントの取り込み

ライセンス

MIT