Shopifymockmcp

🚀 ShopifyのMCP代理サーバーとMockサーバー（ShopifyMCPMockShop）

このプロジェクトは、モデルコンテキストプロトコル（MCP）サーバーを実装しています。このサーバーは、ShopifyのStorefront APIに接続するためのインテリジェントなブリッジとして機能し、代理として動作します。特に、mock.shopをサポートしており、実際のショップの認証情報を使用せずに安全な開発とテストが可能です。

このサーバーは、標準入出力（stdio） を介して通信します。これにより、Claude DesktopやCursorなどのクライアントとのローカル統合に適しています。

🚀 クイックスタート

このサーバーは、ShopifyのStorefront APIとの接続を容易にするためのMCPサーバーです。標準入出力を使用してクライアントと通信し、mock.shopをサポートすることで安全な開発とテストを可能にします。

✨ 主な機能

核心機能

1. MCPサーバーの実装：MCPプロトコルの代理とブリッジとして機能し、様々なクライアントとサービスとの統合をサポートします。
2. Mockサポート：mock.shopを通じて模擬環境を提供し、開発とテストを容易にします。
3. stdio通信：標準入出力を使用して通信するため、互換性と使いやすさが確保されます。

機能モジュール

• Storefront API統合：ShopifyのStorefront APIとの相互作用をサポートします。
• Mock環境設定：模擬データと環境設定を提供し、開発者が機能をテストおよび検証しやすくします。
• 拡張プラグインアーキテクチャ：ユーザーがカスタムプラグインと拡張を追加してサーバーの機能を拡張できるようにします。

📦 インストール

インストール手順

1. プロジェクトリポジトリをクローンします：

   git clone https://github.com/yourusername/shopify-mcp-mock-server.git
   

2. 依存関係をインストールします：

   npm install
   

3. サーバーを起動します：

   npm start
   

💻 使用例

基本的な使用法

// 商店情報リクエストの作成
const response = await fetch('http://localhost:3000', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    toolName: 'getShopInfo'
  })
});

高度な使用法

// Mock環境の設定
// プロジェクトのルートディレクトリにmock-config.jsファイルを作成します
module.exports = {
  shopUrl: 'mock-shop.shop',
  apiKey: 'your-mock-api-key',
  collections: [
    { id: 1, name: 'Mock Collection' },
    // 他の模擬データ...
  ]
};

📚 ドキュメント

関連ツール

コアツール

• getShopInfo：ショップの基本情報（名前、説明、通貨）を取得します。
• findProducts：商品の検索/フィルタリングを行い、ページングとソートをサポートします。
• getProductById：IDに基づいて特定の商品を取得します。
• cartCreate：新しいショッピングカートを作成します。

拡張ツール

• adminGetCustomerById：Admin APIを通じてIDに基づいて顧客情報を取得する予定です。
• adminCreateProduct：Admin APIを通じて新しい商品を作成する予定です。

テストと検証

クイックテスト

1. サーバーを起動します：

   npm start
   

2. http://localhost:3000にリクエストを送信します。例えば、Postmanまたはcurlを使用します：

   curl -X POST http://localhost:3000 \
     -H "Content-Type: application/json" \
     -d '{"toolName": "getShopInfo"}'
   

結果の検証

サーバーはJSON形式のレスポンスを返し、ツール名と関連データが含まれます。例えば：

{
  "toolName": "getShopInfo",
  "shopName": "Mock Shop",
  "description": "A mock shop for development purposes.",
  "currencyCode": "USD"
}

拡張と計画

予定されている機能

1. Admin APIサポート：Shopify Admin APIのサポートを実装し、顧客管理と商品作成を含みます。
2. プラグインシステム：拡張可能なプラグインアーキテクチャを開発し、ユーザーがカスタムロジックと機能を追加できるようにします。
3. 高度な模擬：より複雑な模擬シナリオ（動的データ生成やエラー処理など）を提供します。

将来のアップデート

• より多くのShopify API機能をサポートします。
• サーバーの設定と管理を行うためのグラフィカルインターフェイスを提供します。
• セキュリティとパフォーマンスを強化します。

貢献とサポート

貢献の方法

1. リポジトリをフォークします：

   git clone https://github.com/yourusername/shopify-mcp-mock-server.git
   cd shopify-mcp-mock-server
   

2. 機能ブランチを作成します：

   git checkout -b feature/new-feature
   

3. 変更をコミットし、プルリクエストを作成します。

サポートの取得

• メール：support@shopify.com
• GitHub Issues：Issues リンク