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

Release feeds: [RSS](https://maguyva.ai/th/changelog.xml), [JSON Feed 1.1](https://maguyva.ai/th/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/th/docs/mcp-api) หากตั้งค่าครั้งแรก ให้เริ่มจาก [เริ่มต้นอย่างรวดเร็ว](https://maguyva.ai/th/docs/quickstart)

### เลือกเครื่องมือที่เหมาะสม

คำถามส่วนใหญ่เริ่มได้ด้วยการเรียกเครื่องมือครั้งเดียว ค่อยค้นต่อเมื่อคำตอบแรกกว้างเกินไปหรือให้ข้อมูลน้อยเกินไป

- `intelligent_search` — เริ่มที่นี่เมื่อมีคำถามเกี่ยวกับฐานโค้ดด้วยภาษาธรรมชาติ ค่าเริ่มต้น auto/balanced ส่งคำถามที่ระบุได้อย่างมั่นใจว่าเกี่ยวกับนิยามไปยังการค้นหาเชิงโครงสร้าง ส่งคำถามเกี่ยวกับการอ้างอิงหรือผลกระทบไปยังกราฟ และส่งคำถามที่ต้องการผลตรงกันทุกประการไปยังการค้นหาข้อความ คำถามอื่นใช้ความหมายและข้อความที่จัดทำดัชนีแล้ว ใช้ mode=hybrid หรือ auto ร่วมกับ quality=thorough เพื่อขอใช้รูปแบบการค้นหาทั้งสี่แบบ โดยโหมดที่ระบุไว้อย่างชัดเจนจะมีผลเหนือ quality
- `find_symbol` — คุณรู้ฟังก์ชัน คลาส หรือชื่อตัวแปรอยู่แล้ว
- `dependency_search` — ขอบเขตผลกระทบ: โค้ดที่เรียกใช้ ส่วนประกอบที่พึ่งพา หรือผลกระทบก่อนและหลังการแก้ไข
- `get_task_context` — สำหรับส่วนที่ยังไม่คุ้นเคย รวบรวมไฟล์ สัญลักษณ์ และการพึ่งพาเป็นชุดข้อมูลที่จำกัดขนาดสำหรับคำอธิบายงาน
- `repository_context` — แสดงรายการที่เก็บโค้ดที่เข้าถึงได้ หรือตรวจสอบว่าชื่อที่เก็บโค้ดถูกจับคู่กับที่เก็บใด
- `ask_maguyva` พร้อม `operation="guidance"` — ความช่วยเหลือเฉพาะที่เกี่ยวกับการเลือกเครื่องมือและการใช้งาน Maguyva (ไม่มีการเปลี่ยนแปลง repo)

## Tools -- Search

- [intelligent_search](https://maguyva.ai/th/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/th/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/th/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/th/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/th/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/th/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/th/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/th/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/th/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/th/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/th/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/th/docs/quickstart)
- [คู่มือการติดตั้ง](https://maguyva.ai/th/docs/installation)
- [อ้างอิง MCP API](https://maguyva.ai/th/docs/mcp-api)
- [การแก้ไขปัญหา](https://maguyva.ai/th/docs/troubleshooting)
- [มันทำงานอย่างไร](https://maguyva.ai/th/docs/how-it-works)
- [ความเข้ากันได้และข้อกำหนดทางเทคนิค](https://maguyva.ai/th/docs/compatibility)

## Agent integrations

- [Maguyva สำหรับ Cursor: บริบทโค้ดเบสผ่าน MCP](https://maguyva.ai/th/for-cursor): Cursor แก้ไขไฟล์ที่เปิดอยู่ ส่วน Maguyva ทำดัชนีทั้งโมโนรีโพและส่งข้อมูลกลับผ่าน MCP — ค้นหาเชิงความหมาย เชิงโครงสร้างแบบ AST เชิงกราฟ และเชิงข้อความ พร้อม file:line เพื่อให้เอเจนต์เจอไฟล์ที่คุณไม่ได้ปักหมุดไว้
- [Maguyva สำหรับ Windsurf: บริบทโค้ดเบสผ่าน MCP](https://maguyva.ai/th/for-windsurf): Windsurf และ Cascade แก้ไขไฟล์ที่เปิดอยู่ ส่วน Maguyva ทำดัชนีทั้งโมโนรีโพและส่งข้อมูลผ่าน MCP — ค้นหาเชิงความหมาย เชิง AST เชิงกราฟ และเชิงข้อความ พร้อม file:line เพื่อให้ Cascade เจอไฟล์ที่คุณไม่ได้พูดถึง
- [Maguyva สำหรับ Antigravity: บริบทโค้ดเบสผ่าน MCP](https://maguyva.ai/th/for-antigravity): Antigravity รันเอเจนต์อัตโนมัติข้ามเอดิเตอร์ เทอร์มินัล และเบราว์เซอร์ Maguyva มอบแผนที่ของโมโนรีโพที่สอบถามได้ผ่าน MCP ให้พวกมัน — เห็นรัศมีผลกระทบล่วงหน้า ไม่ใช่หลัง CI ขึ้นแดง
- [Maguyva สำหรับ Codex: บริบทโค้ดเบสผ่าน MCP](https://maguyva.ai/th/for-codex): AGENTS.md คือข้อตกลงการทำงาน Maguyva คือเซิร์ฟเวอร์ MCP ที่มอบแผนที่ของโค้ดที่สามารถสืบค้นได้ให้กับ Codex CLI เพื่อให้การแก้ไขครั้งแรกไม่ใช่การเดา
- [Maguyva สำหรับไคลเอนต์ MCP ใดก็ได้: บริบทโค้ดเบสผ่าน MCP](https://maguyva.ai/th/for-anything): MCP คือโปรโตคอลเปิด Maguyva คือเซิร์ฟเวอร์ MCP มาตรฐาน ดังนั้นไคลเอนต์ที่รองรับ MCP อย่าง Claude Code, Codex CLI, Gemini CLI, Cursor, Windsurf, Antigravity จึงได้บริบทโค้ดเบสที่อ้างอิงจากโค้ดจริงแบบเดียวกัน
- [Maguyva สำหรับ Gemini CLI: บริบทโค้ดเบสผ่าน MCP](https://maguyva.ai/th/for-gemini): GEMINI.md กำหนดบริบทในการทำงาน ส่วน MCP คือช่องทางสื่อสาร Maguyva คือเซิร์ฟเวอร์ MCP ที่มอบแผนที่ของรีโพที่สอบถามได้ให้ Gemini CLI — ค้นหาเชิงความหมาย เชิง AST และเชิงกราฟ เพื่อให้การแก้ไขครั้งแรกไม่ใช่การเดา
- [Maguyva สำหรับ Claude Code: บริบทโค้ดเบสผ่าน MCP](https://maguyva.ai/th/for-claude-code): CLAUDE.md บอก Claude ว่าควรทำงานอย่างไร Maguyva จัดทำดัชนีโค้ดและให้บริการผ่าน MCP เพื่อให้ Claude Code แก้ไขโดยอ้างอิงแผนที่ที่สืบค้นได้
- [Maguyva สำหรับ GitHub Copilot CLI: บริบทของโค้ดผ่าน MCP](https://maguyva.ai/th/for-copilot): คำสั่งที่กำหนดเองบอก Copilot ว่าควรทำงานอย่างไร Maguyva จัดทำดัชนีโค้ดและให้บริการผ่าน MCP เพื่อให้ GitHub Copilot CLI แก้ไขโดยอ้างอิงแผนที่

## Company

- [เกี่ยวกับ Maguyva: ระบบวิเคราะห์โค้ดอัจฉริยะผ่าน MCP](https://maguyva.ai/th/about): ระบบวิเคราะห์โค้ดอัจฉริยะสำหรับโค้ดดิ้งเอเจนต์: การค้นหาเชิงความหมาย, AST, กราฟ และการค้นหาข้อความแบบเต็ม, การค้นหาสัญลักษณ์, การวิเคราะห์ dependency และบริบทของงานในการเรียกครั้งเดียว ครอบคลุมกว่า 284 ภาษา
- [รู้จักทีมของเรา: มนุษย์ 2 คน + ฝูงเอเจนต์ AI](https://maguyva.ai/th/team)
- [วิธีที่เราทำงาน: ไม่มี VC ไม่มีราคาต่อที่นั่ง ไม่มีการล็อกฟีเจอร์](https://maguyva.ai/th/how): ไม่มีเงินทุนจากภายนอก ไม่มีราคาต่อที่นั่ง ข้อมูลของคุณไม่ใช่สินค้า นี่คือวิธีที่ Maguyva ถูกสร้างขึ้น และเหตุผลที่มันตั้งราคาแบบนี้
- [สแตกเทคโนโลยี: PostgreSQL, Tree-sitter, MCP](https://maguyva.ai/th/stack): สแตกเทคนิคที่ขับเคลื่อน Maguyva PostgreSQL, เอ็มเบดดิงจาก Voyage AI, การค้นหาเวกเตอร์แบบควอนไทซ์, AST จาก tree-sitter, และโปรโตคอล MCP
- [บันทึกการเปลี่ยนแปลง](https://maguyva.ai/th/changelog): สิ่งที่เผยแพร่ใน Maguyva: การเปลี่ยนแปลงผลิตภัณฑ์ การอัปเดตดัชนีและเครื่องมือ MCP และบันทึกจากกระบวนการพัฒนา ล่าสุดก่อน
- [สด: Maguyva กำลังสร้างตัวเอง แบบเรียลไทม์](https://maguyva.ai/th/live): ไม่ใช่เดโมที่จัดฉาก นี่คือบันทึกการสั่งงานจริง — ทุกการเรียกเครื่องมือ ทุกข้อผิดพลาด และทุกคอมมิตจากทีมเอเจนต์ AI ที่กำลังสร้าง Maguyva แบบสด ๆ

## Guides

- [ไม่ใช่การค้นหาข้อความแบบเต็มที่สวมเสื้อโค้ตอำพราง ห้าโหมดการสืบค้นที่ผสานเป็นหนึ่งเดียว](https://maguyva.ai/th/beyond-rag): โค้ดต้องการมากกว่าชิ้นส่วนเชิงความหมาย Maguyva ผสานห้าโหมดการสืบค้นเป็นคำตอบเดียวที่จัดอันดับแล้ว อ้างอิงจากรีโปจริงผ่าน MCP ครอบคลุม 284 ภาษา แพ็กเกจ Free ไม่ต้องใช้บัตรเครดิต
- [ไฟล์คำสั่งไม่ใช่แผนที่ของโค้ดคุณ แต่ Maguyva คือแผนที่นั้น](https://maguyva.ai/th/beyond-rules-files): CLAUDE.md และ AGENTS.md บอกเอเจนต์ว่าควรทำตัวอย่างไร แต่ไม่ได้บอกว่าในโค้ดเบสมีอะไรบ้าง Maguyva คือเลเยอร์บริบทโค้ดเบสผ่าน MCP ครอบคลุม 284 ภาษา แพ็กเกจ Free ไม่ต้องใช้บัตรเครดิต
- [การแก้ไขนั้นง่าย แต่การรู้ว่าอะไรจะพังนั้นยาก Maguyva ทำแผนที่ให้](https://maguyva.ai/th/know-what-breaks): ก่อนรีแฟกเตอร์ เอเจนต์ของคุณควรรู้จักโค้ดที่เรียกใช้ โค้ดที่อิมพอร์ต และส่วนประกอบที่พึ่งพาทุกตัว Maguyva ตอบคำถามนั้นจากกราฟการเรียกจริงผ่าน MCP ไม่ใช่แค่ grep แพ็กเกจ Free ไม่ต้องใช้บัตร
- [เริ่มต้นด้วยแพ็กเกจ Free: เลเยอร์บริบทโค้ดเบสสำหรับเอเจนต์เขียนโค้ด AI](https://maguyva.ai/th/map-then-change): ทำแผนที่ก่อน แก้ไขทีหลัง Maguyva มอบแผนที่โค้ดเบสที่สืบค้นได้ให้เอเจนต์เขียนโค้ด AI ของคุณผ่าน MCP ก่อนแก้ไขบรรทัดแรก เครื่องมือ 11 ชิ้น ครอบคลุม 284 ภาษา แพ็กเกจ Free ไม่ต้องใช้บัตรเครดิต
- [เอเจนต์ของคุณเริ่มต้นแบบมองไม่เห็นบนรีโปของคุณ Maguyva มอบแผนที่ให้มัน](https://maguyva.ai/th/stop-flying-blind): เอเจนต์เขียนโค้ดสแกนไฟล์ผิด และแก้ไขก่อนที่จะเข้าใจโค้ด Maguyva มอบแผนที่โค้ดเบสที่สืบค้นได้ให้เอเจนต์ของคุณผ่าน MCP ครอบคลุม 284 ภาษา แพ็กเกจ Free ไม่ต้องใช้บัตรเครดิต