gud-api-mcp

Gud API

エディターに組み込まれた、軽量で機能豊富な API クライアントです。REST API や GraphQL API をテストし、リクエストをコレクションに整理し、環境を管理して、コードスニペットを生成できます。Postman などの外部ツールに切り替える必要はありません。

Open VSX または VS Code Marketplace からインストールできます。サイト：gudapi.gudlab.org。

ソース

エディター拡張機能はプロプライエタリです。このリポジトリは、製品ドキュメントとイシューを公開する場所です。VS Code／Open VSX 拡張機能のソースは含まれていません。

Marketplace または Open VSX から GitHub のリンクをたどってきた場合は、バグ報告や機能リクエストを投稿する場所として、ここで合っています。UI のためにクローンするものはありません。

連携する MCP サーバーは公開されています：@gudlab/gud-api-mcp。ソースは gudlab/gud-api-mcp にあります。ドキュメント：gudapi.gudlab.org/guide/ai-agents。

機能

リクエストビルダー

• すべての HTTP メソッド：GET、POST、PUT、PATCH、DELETE、OPTIONS、HEAD
• URL と双方向に同期し、有効／無効を切り替えられるクエリパラメーターエディター
• 動的なキーと値の行を備えたヘッダーエディター
• 複数のボディ形式：JSON、Form URL Encoded、Multipart Form Data、GraphQL、プレーンテキスト
• ネイティブのファイル選択機能を使った multipart form-data によるファイルのアップロード
• 認証：Bearer Token、Basic Auth、API Key（ヘッダーまたはクエリパラメーター）

GraphQL

• Query と Variables のペインを分けた専用の GraphQL エディター
• メソッドを POST に、Content-Type を application/json に自動設定
• Variables を JSON として解析し、クエリと一緒に送信

レスポンスビューアー

• ステータスコード、レスポンス時間、サイズ、形式の検出（JSON／HTML／XML）
• Pretty／Raw／Preview の切り替え — Preview では、サンドボックス化された iframe に HTML を表示します
• 検索 — 一致件数の表示とナビゲーションで、レスポンスボディ内のテキストを検索します
• Cookies タブ — レスポンスの Set-Cookie ヘッダーを表示します
• ボディまたはヘッダーのコピーボタン

コード生成

• ワンクリックで任意のリクエストからコードを生成
• 言語：cURL、JavaScript（fetch）、Python（requests）、Node.js（axios）
• クリップボードにコピー

リクエスト履歴

• すべてのリクエストを履歴に自動保存（直近 100 件）
• サイドバーでメソッド、URL、ステータス、タイムスタンプとともに履歴を表示
• 任意の履歴項目をクリックして、リクエストビルダーに再読み込み
• VS Code のセッションをまたいで保持

Cookie 管理

• レスポンスの Cookie を自動で取得して保存
• 以降のリクエストでは、一致するドメインの Cookie を自動送信
• Cookie マネージャーで、ドメインごとに Cookie の表示、有効／無効の切り替え、削除が可能
• メモリ内ストレージ — VS Code の再起動時に Cookie はリセットされます

コレクション

• リクエストをコレクションやフォルダーに保存して整理
• 保存済みのリクエストをクリックしてビルダーに読み込み
• 右クリックして、名前の変更、削除、新しいフォルダーの作成
• 深くネストしたフォルダー構造に対応

インポート

• Postman v2.x コレクション（ネストしたフォルダー、ヘッダー、ボディ、コレクション変数を含む）
• Thunder Client コレクション
• OpenAPI 3.x／Swagger 2.0 仕様（パスはリクエストに、タグはフォルダーになります）
• サイドバーのボタンまたはコマンドパレットからインポート

環境と変数

• URL、ヘッダー、本文で {{variable}} 構文を使用できます。送信時に自動的に解決されます
• Postman からインポートしたコレクションレベルの変数（例：{{base_url}}）
• キーと値のエディター、オン／オフ切り替えを備えたユーザー定義の環境
• ツールバーの環境セレクターで、環境をすぐに切り替えられます
• 変数の解決順序：環境の変数がコレクションの変数より優先されます

エディターとの統合

• すばやくアクセスできるアクティビティバーのアイコン
• VS Code のテーマ（ライト、ダーク、ハイコントラスト）に自動で対応します
• ワークスペースを開いていなくても動作します（VS Code のグローバルストレージに保存）
• キーボードショートカット：Enter キーでリクエストを送信

はじめに

1. Open VSX または VS Code Marketplace から拡張機能をインストールします
2. アクティビティバーの Gud API アイコンをクリックします
3. URL を入力し、Send を押します
4. Save をクリックして、リクエストをコレクションに追加します

既存のコレクションをインポートするには、サイドバーの Import をクリックし、Postman、Thunder Client、または OpenAPI の JSON ファイルを選択します。

AI エージェント向け MCP

エージェントは @gudlab/gud-api-mcp を使用して、実際の Gud API コレクションとしてリクエストを作成、実行、保存できます。

{
  "mcpServers": {
    "gud-api": {
      "command": "npx",
      "args": ["-y", "@gudlab/gud-api-mcp", "--project", "."]
    }
  }
}

ソースとツール：gudlab/gud-api-mcp。ガイド：gudapi.gudlab.org/guide/ai-agents。

Free と Pro

Gud API は無料で利用でき、リクエスト、コレクション、フォルダーの数に制限はありません。チーム同期／クラウド同期は Pro の有料機能です。

機能	Free	Pro
リクエスト数無制限	はい	はい
コレクションとフォルダー	はい	はい
インポート（Postman、Thunder Client、OpenAPI）	はい	はい
認証（Bearer、Basic、API Key）	はい	はい
GraphQL 対応	はい	はい
マルチパートフォームデータとファイルのアップロード	はい	はい
コード生成（cURL、fetch、Python、axios）	はい	はい
リクエスト履歴	はい	はい
Cookie 管理	はい	はい
レスポンスの検索と形式の切り替え	はい	はい
コレクション変数	はい	はい
環境	1	無制限
チーム同期	-	はい
クラウドコレクション	-	はい

Pro：月額 $4、または買い切り $29。

サポート

Gud API は無料で利用でき、制限もありません。時間の節約に役立った場合は、開発への支援をご検討ください。

• Buy Me a Coffee
• PayPal

フィードバックと問題の報告

バグの報告や機能のリクエストは、github.com/gudlab/gud-api/issues からお寄せください。

ライセンス

プロプライエタリです。LICENSE をご覧ください。エディターの UI はオープンソースではありません。MCP サーバーには、gudlab/gud-api-mcp に独自のライセンスがあります。