使用说明
@马古瓦/mcp
Maguyva 是一个代码智能MCP服务器：在您的索引存储库中进行语义、结构、图形和文本搜索，因此您的代理可以快速找到所需的内容。
Maguyva是一个 远程流式HTTP MCP服务器 在 https://maguyva.tools/mcp。大多数现代客户端直接连接到它，不需要本地进程。这个包是一个stdio桥，用于无法连接的客户端。
选择你的道路：
| 您的客户 | 使用 |
|---|---|
| Claude Code或OpenAI Codex maguyva/代理插件 插件——捆绑了连接、使用技巧和会话启动指南 | |
支持远程MCP Authorization header（游标、VS代码、Windsurf、Zed、OpenCode、Gemini CLI等） |
直接HTTP配置——见下文 |
| 仅支持stdio的MCP客户端 | 此软件包 |
无论采用哪种路径，都可以从 马古瓦艾 仪表板，并安装使用技巧（请参阅 安装技能)——这项技能教会了你的代理人何时以及如何使用马古瓦的工具。
克劳德法典
从以下位置安装插件 maguyva/代理插件:
/plugin marketplace add maguyva/agent-plugins
/plugin install maguyva@maguyva
export MAGUYVA_API_KEY='<your key>'
该插件直接通过HTTP连接，包括技能和钩子——无需设置其他内容。
直接HTTP（其他一切首选）
如果您的客户端支持自定义的远程MCP服务器 Authorization header，直接连接：
{
"mcpServers": {
"maguyva": {
"url": "https://maguyva.tools/mcp",
"headers": {
"Authorization": "Bearer ${MAGUYVA_API_KEY}"
}
}
}
}
具体的配置形状因客户端而异（VS代码使用 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 代替env变量，以及 --server=URL （或 MAGUYVA_SERVER_URL)以覆盖端点。
安装技能
无论采用何种传输方式，请安装Maguyva技能，以便您的代理知道如何很好地使用这些工具——工具选择、本地grep击败索引搜索时以及故障排除：
curl -fsSL https://maguyva.tools/install-skill.sh | sh -s -- --client <client>
--client 接受 claude, opencode, codex, cursor, vscode, gemini, cline，或 agents （通用 ~/.agents/skills 路径）。该技能是公开的 代理技能标准 并居住在 maguyva/代理插件.Claude Code和Codex插件用户已经拥有它——该插件将其捆绑在一起。
许可证
麻省理工学院
