# Maguyva

Resipi ringkas untuk aliran kerja MCP Maguyva yang biasa: pasang klien, cari sebelum anda mengedit, tangani hasil kosong dan kerja berbilang repo.

[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/ms/docs/quickstart.md) or send `Accept: text/markdown`.

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

## Keupayaan Bahasa

Berikut ialah kiraan keupayaan yang menggerakkan carian struktur, carian simbol, analisis berasaskan graf dan pengindeksan asas.

Penanda ini menunjukkan keupayaan yang didayakan dalam konfigurasi bahasa semasa, bukan skor kualiti keseluruhan proses. Ketersediaan graf memerlukan penghurai, pengekstrakan simbol dan pengekstrakan graf didayakan. Jenis hubungan yang disokong dan kedalaman pengekstrakan berbeza mengikut bahasa.

- Liputan diindeks: **284**. Setiap bahasa yang disenaraikan diindeks untuk konteks fail, teks, dan repositori.
- Carian struktur AST: **247**. Bahasa dengan struktur berasaskan penghurai untuk aliran kerja AST dan carian berstruktur.
- Pengekstrakan simbol: **282**. Bahasa dengan metadata simbol untuk takrif dan carian.
- Hubungan graf: **151**. Bahasa dengan pengekstrakan hubungan yang tersedia untuk carian berasaskan graf. Kedalaman berbeza mengikut bahasa dan jenis hubungan.

- `ast_structural=false`: Pengindeksan teks-dahulu dengan kesedaran struktur yang lebih ringan.
- `symbol_extraction=false`: Pengekstrakan simbol adalah terhad, jadi navigasi lebih bergantung pada konteks fail dan struktur.
- `relationship_extraction=false`: Bahasa ini diindeks untuk carian, tetapi belum disimpan secara berterusan dalam graf kod.

[Cari bahasa anda](/llms-full.txt)

## Buku Resipi

Resipi praktikal untuk kerja Maguyva MCP setiap hari. Setiap resipi menamakan alatan dan urutan — bukan rujukan parameter penuh. Untuk parameter alat, gunakan [Rujukan MCP API](https://maguyva.ai/ms/docs/mcp-api). Untuk persediaan kali pertama, gunakan [Mula pantas](https://maguyva.ai/ms/docs/quickstart).

### Pilih alat yang betul

Kebanyakan soalan bermula dengan satu panggilan. Tingkatkan hanya apabila jawapan pertama terlalu luas atau terlalu nipis.

- `intelligent_search` — mulakan di sini untuk soalan tentang pangkalan kod dalam bahasa semula jadi. Tetapan lalai auto/balanced menghalakan pertanyaan yang dikenal pasti dengan keyakinan tinggi sebagai carian definisi kepada carian berstruktur, soalan tentang rujukan atau kesan kepada graf, dan soalan tentang padanan tepat kepada carian teks. Soalan lain menggunakan makna semantik dan teks yang diindeks. Gunakan mode=hybrid atau auto dengan quality=thorough untuk meminta keempat-empat modaliti carian. Mod yang dipilih secara eksplisit mengatasi tetapan quality.
- `find_symbol` — anda sudah tahu fungsi, kelas atau nama pembolehubah.
- `dependency_search` — lingkungan impak: kod pemanggil, komponen yang bergantung atau impak sebelum dan selepas suntingan.
- `get_task_context` — kawasan yang belum dikenali; satu himpunan terhad fail, simbol dan kebergantungan untuk penerangan tugas.
- `repository_context` — senaraikan repositori yang boleh diakses atau periksa cara nama repositori diselesaikan.
- `ask_maguyva` dengan `operation="guidance"` — bantuan setempat tentang pemilihan alat dan penggunaan Maguyva (tanpa mengubah repositori).

## Tools -- Search

- [intelligent_search](https://maguyva.ai/ms/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/ms/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/ms/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/ms/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/ms/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/ms/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/ms/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/ms/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/ms/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/ms/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/ms/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.

## Langkah seterusnya

- [Mula pantas](https://maguyva.ai/ms/docs/quickstart)
- [Panduan Pemasangan](https://maguyva.ai/ms/docs/installation)
- [Rujukan MCP API](https://maguyva.ai/ms/docs/mcp-api)
- [Menyelesaikan masalah](https://maguyva.ai/ms/docs/troubleshooting)
- [Bagaimana Ia Berfungsi](https://maguyva.ai/ms/docs/how-it-works)
- [Keserasian & Spesifikasi Teknikal](https://maguyva.ai/ms/docs/compatibility)

## Agent integrations

- [Maguyva untuk Cursor: konteks pangkalan kod melalui MCP](https://maguyva.ai/ms/for-cursor): Cursor sunting fail yang terbuka; Maguyva indeks seluruh monorepo dan sampaikannya semula melalui MCP — carian semantik, AST, graf, dan teks dengan file:line, supaya ejen jumpa fail yang anda tak pin.
- [Maguyva untuk Windsurf: konteks pangkalan kod melalui MCP](https://maguyva.ai/ms/for-windsurf): Windsurf dan Cascade sunting fail yang terbuka; Maguyva indeks seluruh monorepo dan sampaikannya melalui MCP — semantik, AST, graf, dan teks dengan file:line, supaya Cascade jumpa fail yang anda tak sebut.
- [Maguyva untuk Antigravity: konteks pangkalan kod melalui MCP](https://maguyva.ai/ms/for-antigravity): Antigravity jalankan ejen autonomi merentasi editor, terminal, dan pelayar; Maguyva bagi mereka peta monorepo yang boleh ditanya melalui MCP — lingkungan impak terus di depan, bukan selepas CI jadi merah.
- [Maguyva untuk Codex: konteks pangkalan kod melalui MCP](https://maguyva.ai/ms/for-codex): AGENTS.md ialah perjanjian kerja. Maguyva ialah pelayan MCP yang memberi Codex CLI peta repo yang boleh dipertanyakan, supaya suntingan pertama bukan tekaan.
- [Maguyva untuk mana-mana klien MCP: konteks pangkalan kod melalui MCP](https://maguyva.ai/ms/for-anything): MCP ialah protokol terbuka. Maguyva ialah pelayan MCP piawai, jadi klien yang menyokong MCP seperti Claude Code, Codex CLI, Gemini CLI, Cursor, Windsurf, Antigravity mendapat konteks codebase yang sama, berasaskan fakta sebenar.
- [Maguyva untuk Gemini CLI: konteks pangkalan kod melalui MCP](https://maguyva.ai/ms/for-gemini): GEMINI.md tetapkan konteks kerja; MCP saluran perantaraannya. Maguyva ialah pelayan MCP yang bagi Gemini CLI peta repo anda yang boleh ditanya — carian semantik, AST, dan graf supaya suntingan pertama bukan tekaan.
- [Maguyva untuk Claude Code: konteks pangkalan kod melalui MCP](https://maguyva.ai/ms/for-claude-code): CLAUDE.md memberitahu Claude cara berkelakuan. Maguyva mengindeks repo dan menyajikannya melalui MCP supaya Claude Code menyunting berdasarkan peta yang boleh dipertanyakan.
- [Maguyva untuk GitHub Copilot CLI: konteks kod melalui MCP](https://maguyva.ai/ms/for-copilot): Arahan tersuai memberitahu Copilot cara berkelakuan. Maguyva mengindeks repo dan menyajikannya melalui MCP supaya GitHub Copilot CLI menyunting berdasarkan peta.

## Company

- [Tentang Maguyva: Kecerdasan Kod melalui MCP](https://maguyva.ai/ms/about): Kecerdasan kod untuk ejen coding: carian semantik, AST, graf dan teks penuh, carian simbol, analisis kebergantungan, dan konteks tugas dalam satu panggilan merentasi 284+ bahasa.
- [Kenali Pasukan: 2 Manusia + Kumpulan Ejen AI](https://maguyva.ai/ms/team)
- [Macam Mana Kami Bekerja: Tiada VC, Tiada Harga Ikut Seat, Tiada Sekatan Ciri](https://maguyva.ai/ms/how): Tiada modal luar. Tiada harga ikut seat. Data anda bukan produk. Macam mana Maguyva dibina dan kenapa harganya macam itu.
- [Stack Teknologi: PostgreSQL, Tree-sitter, MCP](https://maguyva.ai/ms/stack): Stack teknikal yang menggerakkan Maguyva. PostgreSQL, embedding Voyage AI, carian vektor terkuantisasi, AST tree-sitter, dan protokol MCP.
- [Changelog](https://maguyva.ai/ms/changelog): Apa yang telah dilancarkan dalam Maguyva: perubahan produk, kemas kini indeks dan alat MCP, serta nota daripada pembinaan. Terkini dahulu.
- [Langsung: Maguyva Membina Dirinya Sendiri, Secara Masa Nyata](https://maguyva.ai/ms/live): Bukan demo yang telah disediakan. Ini log penugasan sebenar — setiap panggilan alat, ralat, dan commit daripada pasukan ejen AI yang membina Maguyva, secara langsung.

## Guides

- [Bukan carian teks penuh yang menyamar pakai kot panjang. Lima mod capaian yang digabung.](https://maguyva.ai/ms/beyond-rag): Kod perlukan lebih daripada serpihan semantik. Maguyva menggabungkan lima mod capaian menjadi satu jawapan dengan hasil yang diperingkatkan, berasaskan repo sebenar melalui MCP merentasi 284 bahasa. Pelan Free, tiada kad.
- [Fail arahan bukan peta kod anda. Maguyva peta itu.](https://maguyva.ai/ms/beyond-rules-files): CLAUDE.md dan AGENTS.md beritahu ejen macam mana nak berkelakuan. Ia tak beritahu apa yang ada dalam pangkalan kod. Maguyva ialah lapisan konteks pangkalan kod melalui MCP merentasi 284 bahasa. Pelan Free, tiada kad.
- [Suntingan itu mudah. Tahu apa yang rosak itu susah. Maguyva memetakannya.](https://maguyva.ai/ms/know-what-breaks): Sebelum refactor, ejen anda patut tahu setiap pemanggil, pengimport, dan dependen. Maguyva jawab itu daripada graf panggilan sebenar melalui MCP, bukan grep. Pelan Free, tiada kad.
- [Mula percuma: lapisan konteks pangkalan kod untuk ejen pengekodan AI](https://maguyva.ai/ms/map-then-change): Peta dulu. Ubah kemudian. Maguyva bagi ejen pengekodan AI anda peta pangkalan kod yang boleh ditanya melalui MCP, sebelum suntingan pertama. 11 alat merentasi 284 bahasa. Pelan Free, tiada kad.
- [Ejen anda mula secara buta pada repo anda. Maguyva bagi ia peta.](https://maguyva.ai/ms/stop-flying-blind): Ejen pengekodan imbas fail yang salah dan sunting sebelum faham kod itu. Maguyva bagi ejen anda peta pangkalan kod yang boleh ditanya melalui MCP merentasi 284 bahasa. Pelan Free, tiada kad.