Maguyva

@maguyva/mcp

Maguyva はコードインテリジェンス MCP サーバーです。インデックス化されたリポジトリ全体を対象に、セマンティック検索、構造検索、グラフ検索、テキスト検索を行うため、エージェントは必要なものをすばやく正確に見つけられます。

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 キーを取得し、使い方スキルをインストールしてください（スキルのインストールを参照）。このスキルによって、エージェントは 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 スキルをインストールしてください。ツールの選択方法、インデックス検索よりローカルの 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 standard に準拠して作成されており、maguyva/agent-plugins にあります。Claude Code と Codex のプラグインを利用している場合は、プラグインに含まれているため、すでにインストールされています。

ライセンス

MIT