Maguyva

@maguyva/mcp

Maguyva 是一个代码智能 MCP 服务：可在已索引的代码库中进行语义、结构、图谱和文本搜索，让你的 Agent 快速找到所需内容。

Maguyva 是一个位于 https://maguyva.tools/mcp 的远程流式 HTTP MCP 服务。大多数现代客户端都可以直接连接，无需本地进程。对于无法直接连接的客户端，本软件包提供 stdio 桥接。

选择适合你的方式：

你的客户端	使用方式
Claude Code 或 OpenAI Codex	maguyva/agent-plugins 插件——集成了连接配置、使用技能和会话启动指南
支持带 Authorization 标头的远程 MCP（Cursor、VS Code、Windsurf、Zed、OpenCode、Gemini CLI 等）	直接使用 HTTP 配置——见下文
仅支持 stdio 的 MCP 客户端	使用本软件包

无论选择哪种方式，都请从 maguyva.ai 控制面板获取 API 密钥，并安装使用技能（见安装技能）——该技能会教你的 Agent 何时以及如何使用 Maguyva 的工具。

Claude Code / Codex

从 maguyva/agent-plugins 安装插件：

/plugin marketplace add maguyva/agent-plugins
/plugin install maguyva@maguyva
export MAGUYVA_API_KEY='<your key>'

该插件直接通过 HTTP 连接，并包含技能和钩子——无需进行其他设置。

直接使用 HTTP（其他客户端优先选择此方式）

如果你的客户端支持带自定义 Authorization 标头的远程 MCP 服务，请直接连接：

{
  "mcpServers": {
    "maguyva": {
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer ${MAGUYVA_API_KEY}"
      }
    }
  }
}

具体配置格式因客户端而异（VS Code 使用 servers + type: "http"，Gemini CLI 使用 httpUrl，Codex 使用 TOML 等）。安装文档为每个客户端提供了经过验证、可直接复制粘贴的配置片段。

本软件包：stdio 桥接

仅当你的客户端使用 stdio，但无法直接连接远程 HTTP 服务时才需要。它会在本地运行，在客户端的 stdio 传输与 https://maguyva.tools/mcp 之间转发，并在重新连接远程服务时保持本地管道不中断。

需要 Node.js。在客户端的 MCP 配置中添加：

{
  "mcpServers": {
    "maguyva": {
      "command": "npx",
      "args": ["-y", "@maguyva/mcp"],
      "env": {
        "MAGUYVA_API_KEY": "your-api-key"
      }
    }
  }
}

选项：可使用 --api-key=KEY 替代环境变量，并使用 --server=URL（或 MAGUYVA_SERVER_URL）覆盖端点。

安装技能

无论使用哪种传输方式，都请安装 Maguyva 技能，让你的 Agent 了解如何更好地使用这些工具——包括工具选择、何时使用本地 grep 优于索引搜索，以及故障排除：

curl -fsSL https://maguyva.tools/install-skill.sh | sh -s -- --client <client>

--client 可接受 claude、opencode、codex、cursor、vscode、gemini、cline 或 agents（通用的 ~/.agents/skills 路径）。该技能依据开放的 Agent Skills 标准编写，位于 maguyva/agent-plugins 中。Claude Code 和 Codex 插件用户已拥有该技能——插件已将其打包。

许可证

MIT