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

Release feeds: [RSS](https://maguyva.ai/zh-hans/changelog.xml), [JSON Feed 1.1](https://maguyva.ai/zh-hans/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/zh-hans/docs/mcp-api)；首次设置请参阅 [快速入门](https://maguyva.ai/zh-hans/docs/quickstart)。

### 选择合适的工具

大多数问题只需一次调用即可开始。只有首个答案范围太宽或信息不足时，才进一步调用工具。

- `intelligent_search` — 用自然语言询问代码库问题时，从这里开始。 默认的 auto/balanced 会在能够高置信度判断意图时，将定义类问题路由到结构搜索，将引用或影响类问题路由到图搜索，将精确匹配类问题路由到文本搜索。其他问题使用语义搜索和已索引文本。 使用 mode=hybrid，或将 auto 与 quality=thorough 搭配，即可请求全部四种搜索模式。显式指定的 mode 优先于 quality。
- `find_symbol` — 你已经知道函数、类或变量的名称。
- `dependency_search` — 评估影响范围：调用方、依赖该符号的代码，以及编辑前后的影响。
- `get_task_context` — 面对陌生区域时，根据任务描述获取限定范围的一组文件、符号和依赖项。
- `repository_context` — 列出可访问的仓库，或检查仓库名称如何解析。
- 带 `operation="guidance"` 的 `ask_maguyva` — 在本地获取工具选择和 Maguyva 使用帮助（不会修改仓库）。

## Tools -- Search

- [intelligent_search](https://maguyva.ai/zh-hans/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/zh-hans/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/zh-hans/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/zh-hans/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/zh-hans/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/zh-hans/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/zh-hans/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/zh-hans/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/zh-hans/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/zh-hans/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/zh-hans/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/zh-hans/docs/quickstart)
- [安装指南](https://maguyva.ai/zh-hans/docs/installation)
- [MCP API 参考](https://maguyva.ai/zh-hans/docs/mcp-api)
- [故障排除](https://maguyva.ai/zh-hans/docs/troubleshooting)
- [工作原理](https://maguyva.ai/zh-hans/docs/how-it-works)
- [兼容性与技术规格](https://maguyva.ai/zh-hans/docs/compatibility)

## Agent integrations

- [适用于 Cursor 的 Maguyva：通过 MCP 提供代码库上下文](https://maguyva.ai/zh-hans/for-cursor): Cursor 编辑的是当前打开的文件；Maguyva 索引整个 monorepo，并通过 MCP 提供语义、AST、图谱和文本搜索，附带 file:line，让智能体找到你没有 pin 住的那些文件。
- [适用于 Windsurf 的 Maguyva：通过 MCP 提供代码库上下文](https://maguyva.ai/zh-hans/for-windsurf): Windsurf 和 Cascade 编辑的是当前打开的文件；Maguyva 索引整个 monorepo，并通过 MCP 提供语义、AST、图谱和文本搜索，附带 file:line，让 Cascade 找到你没有提及的那些文件。
- [适用于 Antigravity 的 Maguyva：通过 MCP 提供代码库上下文](https://maguyva.ai/zh-hans/for-antigravity): Antigravity 让自主智能体跨编辑器、终端和浏览器运行；Maguyva 通过 MCP 为它们提供一张可查询的 monorepo 地图——提前给出影响范围，而不是等 CI 变红之后才知道。
- [适用于 Codex 的 Maguyva：通过 MCP 提供代码库上下文](https://maguyva.ai/zh-hans/for-codex): AGENTS.md 是工作约定。Maguyva 是为 Codex CLI 提供可查询代码库地图的 MCP 服务器，让第一次编辑不再是猜测。
- [Maguyva 适用于任意 MCP 客户端：通过 MCP 提供代码库上下文](https://maguyva.ai/zh-hans/for-anything): MCP 是一个开放协议。Maguyva 是一个标准的 MCP 服务器，因此像 Claude Code, Codex CLI, Gemini CLI, Cursor, Windsurf, Antigravity 这样支持 MCP 的客户端，都能获得同样的、扎根真实代码库的上下文。
- [适用于 Gemini CLI 的 Maguyva：通过 MCP 提供代码库上下文](https://maguyva.ai/zh-hans/for-gemini): GEMINI.md 设定工作上下文；MCP 是传输通道。Maguyva 是那台 MCP 服务器，为 Gemini CLI 提供一张可查询的代码仓库地图——语义、AST 和图谱搜索，让第一次编辑不再是猜测。
- [适用于 Claude Code 的 Maguyva：通过 MCP 提供代码库上下文](https://maguyva.ai/zh-hans/for-claude-code): CLAUDE.md 告诉 Claude 该如何行事。Maguyva 会对代码库建立索引并通过 MCP 提供，让 Claude Code 基于可查询的地图进行编辑。
- [面向 GitHub Copilot CLI 的 Maguyva：通过 MCP 获取代码上下文](https://maguyva.ai/zh-hans/for-copilot): 自定义指令告诉 Copilot 该如何行事。Maguyva 会对代码库建立索引并通过 MCP 提供，让 GitHub Copilot CLI 基于地图进行编辑。

## Company

- [关于 Maguyva：通过 MCP 实现代码智能](https://maguyva.ai/zh-hans/about): 面向编程智能体的代码智能：语义、AST、图和全文搜索，符号查找，依赖分析，以及跨 284 多种语言的一次调用任务上下文获取。
- [认识我们的团队：2 位人类 + 一群 AI 智能体](https://maguyva.ai/zh-hans/team)
- [我们如何运作：没有风投，不按坐席收费，功能不设付费门槛](https://maguyva.ai/zh-hans/how): 没有外部资本。没有按坐席收费。你的数据不是产品。Maguyva 是如何打造的，又为什么这样定价。
- [技术栈：PostgreSQL、Tree-sitter、MCP](https://maguyva.ai/zh-hans/stack): 支撑 Maguyva 运行的技术栈。PostgreSQL、Voyage AI 嵌入向量、量化向量搜索、tree-sitter AST，以及 MCP 协议。
- [更新日志](https://maguyva.ai/zh-hans/changelog): Maguyva 发布的内容：产品变更、索引与 MCP 工具更新，以及来自构建过程的说明。最新在前。
- [实时动态：Maguyva 正在实时打造自己](https://maguyva.ai/zh-hans/live): 这不是预先录制的演示。这是打造 Maguyva 的 AI 智能体团队的真实调度日志——每一次工具调用、故障和提交，实时呈现。

## Guides

- [不是披着风衣冒充的全文搜索。五种融合检索模式。](https://maguyva.ai/zh-hans/beyond-rag): 代码需要的不只是语义分块。Maguyva 通过 MCP，跨 284 种语言，将五种检索模式融合成一个排好序的答案，扎根于真实仓库。Free 层级，无需信用卡。
- [指令文件不是你代码的地图，Maguyva 才是。](https://maguyva.ai/zh-hans/beyond-rules-files): CLAUDE.md 和 AGENTS.md 告诉智能体该怎么表现，却不会告诉它代码库里到底有什么。Maguyva 是通过 MCP、跨 284 种语言提供的代码库上下文层。Free 层级，无需信用卡。
- [改代码很容易，难的是知道会牵连什么。Maguyva 帮你画出这张图。](https://maguyva.ai/zh-hans/know-what-breaks): 重构之前，你的智能体应该知道每一个调用者、导入者和依赖方。Maguyva 通过 MCP，从真实的调用图谱中给出答案，而不是靠 grep。Free 层级，无需信用卡。
- [免费开始：为 AI 编码智能体提供的代码库上下文层](https://maguyva.ai/zh-hans/map-then-change): 先绘图，再修改。Maguyva 会在第一次编辑之前，通过 MCP 为你的 AI 编码智能体提供一张可查询的代码库地图。11 个工具，覆盖 284 种语言。Free 层级，无需信用卡。
- [你的智能体在你的仓库上一开始是盲目的。Maguyva 给它一张地图。](https://maguyva.ai/zh-hans/stop-flying-blind): 编码智能体会扫描错误的文件，在真正理解代码之前就动手编辑。Maguyva 通过 MCP，跨 284 种语言，为你的智能体提供一张可查询的代码库地图。Free 层级，无需信用卡。