# Maguyva

Maguyva MCP の一般的なワークフローを扱う短いレシピ集です。クライアントのインストール、編集前の検索、結果が空の場合の対処、複数リポジトリでの作業を説明します。

[llms-full.txt — English documentation and MCP schemas](/llms-full.txt)

Markdown representation of any docs page or blog post: append `.md` to its URL (https://maguyva.ai/ja/docs/quickstart.md) or send `Accept: text/markdown`.

Release feeds: [RSS](https://maguyva.ai/ja/changelog.xml), [JSON Feed 1.1](https://maguyva.ai/ja/changelog.json).

## 言語対応機能

以下は、構造検索、シンボル検索、グラフを考慮した分析、基本インデックスを支える機能数です。

これらの表示は、現在の言語設定で有効な機能を示すものであり、エンドツーエンドの品質スコアではありません。グラフを利用するには、パーサー、シンボル抽出、グラフ抽出が有効である必要があります。対応する関係の種類と抽出の深さは、言語によって異なります。

- インデックス済みの範囲: **284**. 掲載されているすべての言語は、ファイル、テキスト、リポジトリのコンテキストについてインデックスされています。
- AST構造検索: **247**. パーサーに基づいた構造を持ち、ASTおよび構造検索のワークフローに対応する言語。
- シンボル抽出: **282**. 定義や検索に使うシンボルのメタデータを持つ言語。
- グラフ関係: **151**. グラフを考慮した検索に利用する関係抽出が有効な言語。抽出の深さは、言語および関係タイプによって異なります。

- `ast_structural=false`: 構造把握が簡易的な、テキスト優先のインデックス。
- `symbol_extraction=false`: シンボル抽出が限定的なため、ナビゲーションはファイルと構造のコンテキストにより依存します。
- `relationship_extraction=false`: この言語は検索用にインデックスされていますが、現時点ではコードグラフに永続化されていません。

[言語を探す](/llms-full.txt)

## レシピ集

日常的な Maguyva MCP 作業のための実践的なレシピです。各レシピではツールと手順を示しますが、パラメータの完全なリファレンスではありません。ツールのパラメータは [MCP API リファレンス](https://maguyva.ai/ja/docs/mcp-api)、初回セットアップは [クイックスタート](https://maguyva.ai/ja/docs/quickstart) を参照してください。

### 適切なツールを選ぶ

ほとんどの質問は1回の呼び出しから始められます。最初の回答の範囲が広すぎる、または情報が不足している場合にだけ、さらに掘り下げます。

- `intelligent_search` — コードベースについて自然言語で質問する場合は、ここから始めてください。 デフォルトの auto/balanced は、意図を高い確度で判定できる定義の質問を構造検索へ、参照や影響の質問をグラフへ、完全一致の質問をテキスト検索へ振り分けます。それ以外の質問には、意味に基づく検索とインデックス済みテキストを使います。 4 つすべてを要求するには mode=hybrid、または auto と quality=thorough を指定します。明示的に指定した mode は quality より優先されます。
- `find_symbol` — 関数、クラス、変数の名前がすでに分かっている場合に使います。
- `dependency_search` — 編集前後の影響範囲、つまり呼び出し元、依存元、変更の波及を確認します。
- `get_task_context` — 不慣れな領域で、タスク記述に関係するファイル、シンボル、依存関係を 1 つの限定された束として取得します。
- `repository_context` — アクセス可能なリポジトリを一覧表示するか、リポジトリ名の解決方法を調べます。
- `operation="guidance"` を指定した `ask_maguyva` — ツール選択と Maguyva の使い方をローカルで案内します（リポジトリは変更しません）。

## Tools -- Search

- [intelligent_search](https://maguyva.ai/ja/docs/mcp-api#intelligent-search): Start here for any codebase question. Default auto/balanced routes confident definition queries to structural search, reference/impact queries to graph, and exact-match queries to text; other queries use semantic plus text.
- [semantic_search](https://maguyva.ai/ja/docs/mcp-api#semantic-search): Find code by meaning, not exact text. Use for conceptual queries like "retry logic" or "user onboarding flow" when you don't know the keyword or symbol name.
- [text_pattern_search](https://maguyva.ai/ja/docs/mcp-api#text-pattern-search): Search indexed content. Exact and regex modes grep the full file/blob corpus; fuzzy content mode searches the bounded semantic chunk corpus.

## Tools -- Structural & Graph

- [structural_search](https://maguyva.ai/ja/docs/mcp-api#structural-search): Prefer preset=functions|classes|methods|imports|variables (or free pattern=). Find code by AST shape (not text).
- [dependency_search](https://maguyva.ai/ja/docs/mcp-api#dependency-search): Primary blast-radius / graph surface. Answer "what calls this?" / "what does this use?" via the real call/import graph.

## Tools -- Code Analysis

- [find_symbol](https://maguyva.ai/ja/docs/mcp-api#find-symbol): Jump to where a function, class, or variable is defined and used. Use when you know the name (e.g. "getCurrentUser") — faster and more precise than Grep, and it spans the whole indexed repo.
- [analyze_dependencies](https://maguyva.ai/ja/docs/mcp-api#analyze-dependencies): Analyze blast radius using the same traversal as dependency_search (dependents/incoming). Prefer dependency_search with analysis_type="dependents" or "impact" for impact analysis.
- [get_task_context](https://maguyva.ai/ja/docs/mcp-api#get-task-context): Starting work in an unfamiliar area? Describe the task (e.g. "add SSO support", "fix the billing webhook") and get a bounded one-call bundle of relevant files, code, symbols, and dependencies.
- [get_file](https://maguyva.ai/ja/docs/mcp-api#get-file): Read a file from the indexed repo by path. Prefer local file tools for files on disk; use this for remote indexed snapshots.

## Tools -- Utility

- [repository_context](https://maguyva.ai/ja/docs/mcp-api#repository-context): List the repositories you can search, or get identity info on one (namespace/branch, indexed_commit_sha / index freshness). Use action:"list" when the repo slug is unknown; searches accept a known slug directly or default to your key's single repo.
- [ask_maguyva](https://maguyva.ai/ja/docs/mcp-api#ask-maguyva): Get Maguyva tool guidance, or submit a bug report / feature request stored for Maguyva's maintainers. Never include secrets or sensitive personal data in feedback.

## 次のステップ

- [クイックスタート](https://maguyva.ai/ja/docs/quickstart)
- [インストールガイド](https://maguyva.ai/ja/docs/installation)
- [MCP API リファレンス](https://maguyva.ai/ja/docs/mcp-api)
- [トラブルシューティング](https://maguyva.ai/ja/docs/troubleshooting)
- [仕組み](https://maguyva.ai/ja/docs/how-it-works)
- [互換性と技術仕様](https://maguyva.ai/ja/docs/compatibility)

## Agent integrations

- [Cursor向けMaguyva: MCP経由のコードベースコンテキスト](https://maguyva.ai/ja/for-cursor): Cursorが開いているファイルを編集します。Maguyvaはモノレポ全体をインデックス化し、MCP経由で返します -- セマンティック、AST、グラフ、テキスト検索をfile:line付きで。だから、エージェントはあなたがピン留めしなかったファイルも見つけられます。
- [Windsurf向けMaguyva: MCP経由のコードベースコンテキスト](https://maguyva.ai/ja/for-windsurf): WindsurfとCascadeが開いているファイルを編集します。Maguyvaはモノレポ全体をインデックス化し、MCP経由で返します -- セマンティック、AST、グラフ、テキストをfile:line付きで。だから、Cascadeはあなたが言及しなかったファイルも見つけられます。
- [Antigravity向けMaguyva: MCP経由のコードベースコンテキスト](https://maguyva.ai/ja/for-antigravity): Antigravityは、エディタ、ターミナル、ブラウザにまたがって自律的なエージェントを実行します。Maguyvaは、MCP経由でモノレポの問い合わせ可能な地図をエージェントに提供します -- ブラストラディウスは、CIが赤くなった後ではなく、事前に。
- [Codex向けMaguyva: MCP経由のコードベースコンテキスト](https://maguyva.ai/ja/for-codex): AGENTS.mdは作業上の取り決めです。MaguyvaはCodex CLIにリポジトリのクエリ可能なマップを提供するMCPサーバーであり、最初の編集を推測にしません。
- [あらゆるMCPクライアント向けMaguyva: MCP経由のコードベースコンテキスト](https://maguyva.ai/ja/for-anything): MCPはオープンなプロトコルです。Maguyvaは標準的なMCPサーバーなので、Claude Code、Codex CLI、Gemini CLI、Cursor、Windsurf、AntigravityのようなMCP対応クライアントは、同じ裏付けのあるコードベースのコンテキストを得られます。
- [Gemini CLI向けMaguyva: MCP経由のコードベースコンテキスト](https://maguyva.ai/ja/for-gemini): GEMINI.mdは、作業のコンテキストを定めます。MCPはそのチャネルです。Maguyvaは、あなたのリポジトリの問い合わせ可能な地図をGemini CLIに与えるMCPサーバーです -- セマンティック、AST、グラフ検索により、最初の編集が当てずっぽうにならずに済みます。
- [Claude Code向けMaguyva: MCP経由のコードベースコンテキスト](https://maguyva.ai/ja/for-claude-code): CLAUDE.mdはClaudeにどう振る舞うべきかを伝えます。Maguyvaはリポジトリをインデックスし、MCP経由で提供することで、Claude Codeがクエリ可能なマップをもとに編集できるようにします。
- [GitHub Copilot CLI向けMaguyva: MCP経由のコードコンテキスト](https://maguyva.ai/ja/for-copilot): カスタム指示はCopilotにどう振る舞うべきかを伝えます。Maguyvaはリポジトリをインデックスし、MCP経由で提供することで、GitHub Copilot CLIがマップをもとに編集できるようにします。

## Company

- [Maguyvaについて：MCPによるコードインテリジェンス](https://maguyva.ai/ja/about): コーディングエージェントのためのコードインテリジェンス：セマンティック検索、AST検索、グラフ検索、全文検索、シンボル検索、依存関係分析、そして284以上の言語にわたる1回の呼び出しでのタスクコンテキスト取得。
- [チーム紹介: 人間2人 + AIエージェント軍団](https://maguyva.ai/ja/team)
- [私たちの仕組み: VCなし、シート課金なし、機能制限なし](https://maguyva.ai/ja/how): 外部資本なし。シート課金なし。あなたのデータは商品ではありません。Maguyvaがどう作られ、なぜこの価格なのかについて。
- [テクノロジースタック: PostgreSQL、Tree-sitter、MCP](https://maguyva.ai/ja/stack): Maguyvaを支える技術スタック。PostgreSQL、Voyage AI埋め込み、量子化されたベクトル検索、tree-sitterによるAST、そしてMCPプロトコル。
- [更新履歴](https://maguyva.ai/ja/changelog): Maguyvaでリリースされた内容: プロダクトの変更、インデックスとMCPツールの更新、ビルドからのメモ。新しい順に表示。
- [ライブ：Maguyvaは自らをリアルタイムで構築中](https://maguyva.ai/ja/live): 台本通りのデモではありません。これはMaguyvaを構築するAIエージェントチームの、すべてのツール呼び出し、障害、コミットを記録した実際のディスパッチログです。リアルタイムで更新されます。

## Guides

- [全文検索がトレンチコートを着ているだけの代物じゃない。5つの検索モードを融合させた。](https://maguyva.ai/ja/beyond-rag): コードに必要なのは、セマンティックチャンクだけではありません。Maguyvaは、284言語にわたってMCP経由で実際のリポジトリに根ざした、5つの検索モードを1つのランク付けされた回答に融合します。Freeプラン、カード不要。
- [指示ファイルは、あなたのコードの地図ではありません。Maguyvaはそうです。](https://maguyva.ai/ja/beyond-rules-files): CLAUDE.mdやAGENTS.mdは、エージェントにどう振る舞うかを教えます。でも、コードベースの中に何があるかは教えてくれません。Maguyvaは、284言語にわたってMCP経由で提供される、コードベースのコンテキストレイヤーです。Freeプラン、カード不要。
- [編集は簡単。何が壊れるかを知るのが難しい。Maguyvaがそれを地図にします。](https://maguyva.ai/ja/know-what-breaks): リファクタリングの前に、あなたのエージェントは、すべての呼び出し元、インポートしている箇所、依存元を把握しておくべきです。Maguyvaは、grepではなく実際のコールグラフから、MCP経由でそれに答えます。Freeプラン、カード不要。
- [無料で始める: AIコーディングエージェントのためのコードベースコンテキストレイヤー](https://maguyva.ai/ja/map-then-change): 地図が先。変更は後。Maguyvaは、最初の編集の前に、MCP経由で問い合わせ可能なコードベースの地図を、あなたのAIコーディングエージェントに提供します。284言語にわたる11個のツール。Freeプラン、カード不要。
- [あなたのエージェントは、あなたのリポジトリで何も見えない状態から始まります。Maguyvaが地図を与えます。](https://maguyva.ai/ja/stop-flying-blind): コーディングエージェントは、間違ったファイルをスキャンし、コードを理解する前に編集してしまいます。Maguyvaは、284言語にわたってMCP経由で、問い合わせ可能なコードベースの地図をあなたのエージェントに提供します。Freeプラン、カード不要。