@stronger-ecommerce/gadget-mcp

Name: Gadget MCP Server
Author: Stronger-eCommerce

あらゆるGadgetアプリに対応した汎用読み取り専用MCPサーバーです。 GraphQLイントロスペクションを使用して任意のモデルをクエリできます。生成されたクライアントは不要です。

Stronger eCommerceによって構築されました。

クイックセットアップ（推奨）

Gadgetプロジェクトディレクトリ内から対話型セットアップウィザードを実行します。 .gadget/sync.jsonからアプリのスラッグを自動検出し、設定を自動的に書き込みます。

npx @stronger-ecommerce/gadget-mcp setup

ウィザードは以下の処理を行います：

.gadget/sync.jsonからアプリのスラッグを検出（存在する場合）
APIキーと環境の入力を要求
Claude Code用の実行可能なclaude mcp addコマンドを出力
Cursor用の~/.cursor/mcp.jsonを自動的に書き込み

手動セットアップ

1. 本番環境用APIキーの取得

https://<your-app>.gadget.app/edit/settings/api-keysにアクセスし、読み取り権限を持つキーを作成します。

2. Claude Codeへの登録

claude mcp add my-app-gadget \
  -e GADGET_APP=my-app \
  -e GADGET_API_KEY=your_key_here \
  -- npx @stronger-ecommerce/gadget-mcp

異なる名前で複数のアプリを登録できます：

claude mcp add app-one-gadget \
  -e GADGET_APP=my-first-app \
  -e GADGET_API_KEY=key1 \
  -- npx @stronger-ecommerce/gadget-mcp

claude mcp add app-two-gadget \
  -e GADGET_APP=my-second-app \
  -e GADGET_API_KEY=key2 \
  -- npx @stronger-ecommerce/gadget-mcp

3. Cursorへの登録

~/.cursor/mcp.jsonに追加します：

{
  "mcpServers": {
    "app-one-gadget": {
      "command": "npx",
      "args": ["@stronger-ecommerce/gadget-mcp"],
      "env": {
        "GADGET_APP": "my-first-app",
        "GADGET_API_KEY": "key1"
      }
    },
    "app-two-gadget": {
      "command": "npx",
      "args": ["@stronger-ecommerce/gadget-mcp"],
      "env": {
        "GADGET_APP": "my-second-app",
        "GADGET_API_KEY": "key2"
      }
    }
  }
}

環境変数

変数	必須	デフォルト	説明
`GADGET_APP`	はい	—	アプリのスラッグ（例: `my-app`）
`GADGET_API_KEY`	はい	—	本番環境用APIキー
`GADGET_ENVIRONMENT`	いいえ	`production`	`production` または `development`

ツール

ツール	説明
`list_models`	アプリ内で利用可能なすべてのモデルを一覧表示
`introspect_model`	モデルのフィールドと型を表示
`query_records`	フィルターとフィールド選択を使用して任意のモデルをクエリ
`get_record`	IDを指定して単一のレコードを取得
`run_graphql`	生の読み取り専用GraphQLクエリを実行（ミューテーションはブロックされます）

使用例

接続後、Claudeに以下のように尋ねてください：

"Gadgetアプリのモデルを一覧表示して"
"shopifyOrderモデルのフィールドを見せて"
"メールアドレスが customer@example.com である注文を探して"
"エラーがあるすべてのレコードを取得して"

今後の機能

計画中のアイデアや調査メモ（エージェント用のログやggt統合を含む）はFUTURE_FEATURES.mdに記載されています。

コントリビューション

バグ報告やプルリクエストを歓迎します！

バグを見つけましたか？ Issueを開いてください
修正や機能追加はありますか？ リポジトリをフォークし、変更を加えてmainブランチに対してPRを開いてください
大幅な変更を行う場合は、アプローチを調整するためにまずIssueを開いてください

ローカルでの実行

git clone https://github.com/Stronger-eCommerce/gadget-mcp
cd gadget-mcp
npm install
npm run build
npm test

について

Stronger eCommerce — Shopify開発およびEコマース運用により、愛を込めて作成されました。

Install Server

A

security – no known vulnerabilities

F

license - not found

A

quality - A tier

How are these scores calculated?

Resources

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Gadget MCP Server