storeport

storeport

storeport は、Shopify での開発を支援する小さなコンパニオンです。Shopify の開発者向け機能は幅広く、多数の API、大規模な GraphQL スキーマ、膨大なドキュメントがあります。storeport は、日常的な開発タスクを一か所にまとめます。ガイド付きのコンテキストで API の学習を始める、ドキュメントを検索して、チャンクだけでは足りない場合にページ全体を取得する、Admin GraphQL スキーマで型やフィールドを調べる、開発者アシスタントに直接質問する、リリース前に GraphQL やコンポーネントのコードブロックを検証する、といったことができます。1 つのバイナリで、コマンドラインインターフェースと stdio MCP サーバーの両方を利用できます。

Shopify ストアのトークンも API キーも必要ありません。接続先は Shopify の公開開発者サービスであり、storeport は認証ヘッダーを送信しません。ベース URL の既定値は https://shopify.dev で、SHOPIFY_DEV_BASE_URL 環境変数で上書きできます。

インストール

npx @reneturcios/storeport search "metafields"

または、コンテナーイメージを実行します。

docker run -i ghcr.io/cloudcorprecords/storeport

コンテナーは既定で MCP サーバーを起動します（以下を参照）。CLI として使用するには、CLI の引数を渡してください。

CLI

storeport learn admin-graphql
storeport learn functions --conversation-id conv-1
storeport search "checkout extensibility"
storeport search webhooks --max 5
storeport docs https://shopify.dev/docs/apps/build/checkout
storeport docs /docs/api/admin-graphql
storeport introspect Product
storeport introspect Order --api-version 2025-10
storeport ask "How do I store extra product data?"
storeport validate-graphql '{ shop { name } }'
storeport validate-components '<s-page heading="Hi"></s-page>'

storeport --version

各コマンドは、接続先から返された JSON ペイロードを出力します。終了コード：成功時は 0、呼び出しに失敗した場合（接続先 API のエラーを含む）は 1、使用方法に誤りがある場合は 2 です。空のクエリ、プロンプト、コンテンツ、URL は、リクエストを行う前に拒否されます。

MCP サーバー

1 つのバイナリで両方の用途に対応しています。mcp サブコマンドを実行すると、stdio MCP サーバーが起動します。

npx -y @reneturcios/storeport mcp

MCP クライアントの設定：

{
  "mcpServers": {
    "storeport": {
      "command": "npx",
      "args": ["-y", "@reneturcios/storeport", "mcp"]
    }
  }
}

キー不要のサーバーなので、env ブロックは必要ありません。

ツール

ツール	入力	返される内容
learn_shopify_api	api（必須）、conversationId（任意）	指定した API のガイド付き学習コンテキスト。
search_docs_chunks	query（必須）、maxNumResults（任意）	関連性が最も高いドキュメントのチャンク。
fetch_full_docs	url（必須）	ドキュメントページ 1 件の全文。絶対 URL はそのまま取得し、パスはベース URL に結合します。
introspect_graphql_schema	query（必須）、apiVersion（任意）	検索語に一致する Admin GraphQL の型とフィールド。
prompt_shopify_dev_assistant	prompt（必須）、conversationId（任意）	開発者アシスタントの回答。
validate_graphql_codeblocks	content（必須）、apiVersion（任意）	GraphQL コードブロックごとの検証結果。
validate_component_codeblocks	content（必須）	Shopify コンポーネントのコードブロックの検証結果。

すべての呼び出しは、設定されたベース URL（既定値は https://shopify.dev）を使用して Shopify の開発者サービスに送信されます。このビルドで対応するのは、ドキュメント化された開発者向け機能の中核部分です。Liquid／テーマのコードブロック検証、その他のフレームワーク向けコンポーネント検証、ドキュメントの更新／フィードバックツールには対応していません。

開発

npm install
npm run build   # tsc -> dist/
npm test        # node test runner over test/*.test.ts, no network (fake fetch fixtures)
npm run dev     # run the CLI from source via tsx

ライセンス

MIT — LICENSE を参照してください。