# Maguyvaの技術基盤

Canonical source: https://maguyva.ai/ja/stack

License: text under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/); code samples under [MIT-0](https://opensource.org/license/mit-0); the Maguyva name, logos, brand assets and other code are not covered. Details: [maguyva.ai/license](https://maguyva.ai/license).

速度、デバッグのしやすさ、継続的な改善のために設計されています。中核には実績のあるインフラを据え、コードインテリジェンスが必要な部分には専用設計のコンポーネントを配置しています。

- PostgreSQL + Lance
- 量子化ベクトル検索
- コード言語エンジン
- どこでもMCP
- 285+言語

## 本番環境で動いているもの

これらは、何度もの反復を経て残ったコアレイヤーです。そのすべてが、デバッグを容易にするか、エージェントの実行における摩擦を取り除くことで、その存在意義を勝ち取ってきました。

### PostgreSQL + Lance

*データベース*

テナントごとに分割されたストレージとインデックス。ユーザー間でインデックスが混ざることはなく、あなたのコードは分離された状態を保ちます。

### Voyage AI: voyage-4-large

*埋め込み*

エージェントの検索、取得、グラウンディングのための、高再現率のコード埋め込み。

### Binary Quantized HNSW

*ベクトル検索*

埋め込みを2048ビットのシグネチャに圧縮し、HNSWでインデックス化。ストレージを32分の1に削減し、低レイテンシの検索を、追加インフラなしで実現。

### コード言語エンジン

*言語エンジン*

カスタム文法、ハンドラーヒューリスティック、285言語分の抽出カバレッジを備えた、大幅に改造されたTree-sitterスタック

### MCPプロトコル

*プロトコル*

Claude Code、Claude Desktop、Cursor、VS Code、Devin Desktop、その他のMCP互換クライアント 向けのリモート MCP サーバー。TypeScript Cloudflare Worker 上で 11 個のツールとネイティブのstreamable HTTP トランスポートを提供します。

### Lanceカラム型 + R2

*キャッシュ*

カラム型キャッシュ、クラウド同期される埋め込み

## 行き止まりを経た後のスタック

Maguyvaは一気にこの形にたどり着いたわけではありません。各レイヤーが生き残ったのは、システムを理解しやすくし、運用コストを下げ、プレッシャーの中でもデバッグしやすくしたからです。

オーケストレーションの実験自体はもっと早くから始まっていました。この年表は、Maguyvaというプロダクトそのものの方向性が定まった2025年9月から始まります。

- **2025-Q3** (基盤): 集中的なMaguyva開発が始動 → Voyage voyage-code-3. プロダクトの方向性が固まり、高速な反復のループが始まる
- **2025-Q3** (ストレージ): バイナリベクトル検索レイヤー. コンパクトなインデックスによる量子化検索、別立てのベクトルスタックは不要
- **2025-Q4** (ASTエンジン): コード言語エンジンが稼働開始. 285言語にわたる、カスタムクエリ、パーサーのフォールバック、ハンドラーベースのヒューリスティック
- **2025-Q4** (検索): マルチモーダル融合検索. 1回のクエリで、セマンティック、テキスト、AST、グラフの各インデックスを横断してランク付けされた検索結果を取得
- **2026-Q1** (キャッシュ): Lanceカラム型 + R2同期. サーバーサイドのカラム型キャッシュにより、コールドスタートを高速化
- **2026-Q1** (品質): 285言語対応の検証フレームワーク. 対応するすべての言語にわたる、自動化された抽出テスト
- **2026-Q1** (ローンチ): maguyva.aiで一般公開. 集中的な開発開始から一般提供開始まで7か月
- **2026-Q2** (プロトコル): TypeScript Cloudflare Worker 上の MCP. ネイティブのstreamable HTTP トランスポートで遅延を削減し、稼働中のトラフィック下で切り替え
- **NOW** (埋め込み): 本番環境の埋め込み → voyage-4-large. voyage-code-3 からの切り替え後、より高い再現率を実現するセマンティック検索

## 私たちは自社製品の上で動く

Maguyvaは、Maguyva自身の上で動くエージェントによって構築されています。

私たちのオーケストレーションシステムは、あなたが使うのと同じMCPツール、検索インデックス、本番インフラを使う専門エージェントたちを調整しています。社内専用バージョンは存在しません。チームページには“1x Maguyva ($149) — 自分たちで払っている”と書かれています。これは冗談ではありません。請求書そのものです。

// カスタマーゼロは毎日本番環境にデプロイする

## 本番環境で生き残ったルール

これらは、本番環境で役立ち続けている制約です。イデオロギーの話というよりも、エージェントが高速に変更を加える中でも、システムを理解可能な状態に保つための工夫です。

### サイレントフォールバックなし

早く失敗し、早く直す。すべてのエラーは即座に表面化します。本番環境でバグを隠すような、縮退運転はありません。

*// パニック > サイレント破損*

### RPCファースト

パフォーマンスのためのデータベース側ロジック。PostgreSQL関数がデータの近くで実行され、ラウンドトリップをなくします。

*// PostgreSQL関数、ORMは0個*

### CQRS

書き込みと読み取りのパスを分離。インデックス化パイプラインが書き込み、MCPツールが読み取りを行う。それぞれ異なる最適化戦略。

*// 書き込み: バッチ処理 | 読み取り: キャッシュ済み*

### 決定論的UUID

データベース検索なしでキャッシュの一貫性を保つ。同じ入力 = 同じID。設計段階から冪等な操作。

*// uuid5(namespace, content_hash)*

最高のアーキテクチャとは、午前3時でもデバッグできるものだ。 (実際に試した。)

// 最終更新: 2026-10

[自分のリポジトリで試す](https://app.maguyva.ai/auth/sign-up?plan=free)

## あなたのコードはどこにあるのか

謎はありません。リポジトリを接続したときに、あなたのコードに何が起こるかをそのままお伝えします。

- **ベアメタルサーバー、米国東部** (コンピュート): アッシュバーンにあるベアメタルマシン。ノイズの多い汎用インスタンスではなく、インデックス化のスループットに合わせてチューニングされています。
- **Cloudflareのグローバル CDN** (エッジ): APIおよびMCPのレスポンスはエッジでキャッシュされます。静的アセットはCloudflareのグローバルネットワークから配信されます。
- **ワークスペースごとにテナント分割** (分離): 各ワークスペースは、パイプラインとデータベース全体にわたってテナント単位でスコープされたリポジトリインデックスを持ちます。顧客のコードは、コードインテリジェンスを提供するために使用するのであって、モデルの学習やデータ販売のためではありません。
- **シンガポール法人** (運営法人): UT International PTE. LTD. 実在する法域、実在する法人です。
- **リポジトリを削除すれば、インデックスも削除** (削除): リポジトリの接続を解除すると、Maguyvaはアクティブなインデックス済みソースコード、埋め込み、グラフデータをサービスから削除します。残存バックアップは保持スケジュールに従って期限切れになります。
- **EUやAUが必要ですか?** (リージョン): 追加のデプロイリージョンについては、データ保管要件のある顧客の方とご相談させていただきます。

## 次のステップ

- [はじめる](https://maguyva.ai/ja/docs): 最初のリポジトリを数分でインデックス化。
- [料金を見る](https://maguyva.ai/ja/pricing): ユーザー単位ではなくワークスペース単位。無料で始められます。
- [チームを紹介](https://maguyva.ai/ja/team): 人間2人とAIエージェントの大群。
- [ブログを読む](https://maguyva.ai/ja/blog): 開発現場からの技術メモ。