Shopify Liquid MCP

🚀 Shopify Liquid MCP Server

🚀 高速でローカル、オフライン対応のMCPサーバーで、Shopify Liquidのドキュメントを提供します。全てのタグ、フィルター、オブジェクトを含む198の包括的なドキュメントが用意されています。

このサーバーは、Model Context Protocol (MCP)に対応した専用サーバーで、ClaudeやCursorなどのAIアシスタントやその他のMCP対応ツールに、Shopify Liquidの完全なドキュメントに即座にアクセスできるようにします。

🚀 クイックスタート

このサーバーは、Shopify Liquidのドキュメントを提供するために最適化されたMCPサーバーです。以下で、このサーバーの特徴や使用方法について説明します。

✨ 主な機能

• 🚀 超高速 - ローカルのSQLite FTS5検索（応答時間<1ms）
• 📚 完全なカバレッジ - 30のタグ、101のフィルター、67のオブジェクト（合計198のドキュメント）
• 🔌 オフライン対応 - ネットワーク要求が不要で、どこでも動作します
• 🐳 Docker対応 - 1つのコマンドでデプロイできます
• 🎨 IDE統合 - VS Code、Cursor、Claude Desktop、Zedで動作します
• 🔧 カスタマイズ可能 - 独自のドキュメントを追加できます
• 📖 豊富なドキュメント - すべての構文、パラメーター、例が用意されています
• 🔍 スマート検索 - スニペットのハイライト付きの全文検索

📦 インストール

オプション1: pipを使用する（推奨）

pip install git+https://github.com/florinel-chis/shopify-liquid-mcp.git

オプション2: Dockerを使用する

# イメージを取得する
docker pull florinel-chis/shopify-liquid-mcp:latest

# または、ローカルでビルドする
docker build -t shopify-liquid-mcp .
docker run -it shopify-liquid-mcp

オプション3: docker-composeを使用する

docker-compose up -d

オプション4: ソースからインストールする

git clone https://github.com/florinel-chis/shopify-liquid-mcp.git
cd shopify-liquid-mcp
pip install -e .

💻 使用例

VS Codeでの使用

Dockerを使用する場合

.vscode/settings.jsonを作成または編集します。

{
  "mcp.servers": {
    "shopify-liquid": {
      "type": "docker",
      "image": "shopify-liquid-mcp:latest",
      "transport": "stdio"
    }
  }
}

ローカルインストールを使用する場合

プロジェクトのルートに.mcp.jsonを作成します。

{
  "mcpServers": {
    "shopify-liquid": {
      "type": "stdio",
      "command": "shopify-liquid-mcp"
    }
  }
}

または、VS Codeの設定に追加します。

{
  "mcp.servers": {
    "shopify-liquid": {
      "command": "shopify-liquid-mcp",
      "args": [],
      "transport": "stdio"
    }
  }
}

Claude Desktopでの使用

~/Library/Application Support/Claude/claude_desktop_config.json（macOS）または%APPDATA%\Claude\claude_desktop_config.json（Windows）を編集します。

Dockerを使用する場合

{
  "mcpServers": {
    "shopify-liquid": {
      "type": "stdio",
      "command": "docker",
      "args": ["run", "-i", "--rm", "shopify-liquid-mcp:latest"]
    }
  }
}

ローカルインストールを使用する場合

{
  "mcpServers": {
    "shopify-liquid": {
      "command": "shopify-liquid-mcp"
    }
  }
}

Cursorでの使用

CursorのMCP設定（Settings > Features > MCP Servers）に追加します。

{
  "mcpServers": {
    "shopify-liquid": {
      "command": "shopify-liquid-mcp"
    }
  }
}

または、Dockerを使用する場合

{
  "mcpServers": {
    "shopify-liquid": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "shopify-liquid-mcp:latest"]
    }
  }
}

Zed Editorでの使用

.zed/settings.jsonを作成します。

{
  "context_servers": {
    "shopify-liquid": {
      "command": "shopify-liquid-mcp"
    }
  }
}

Continue.devでの使用

~/.continue/config.jsonを編集します。

{
  "mcpServers": [
    {
      "name": "shopify-liquid",
      "command": "shopify-liquid-mcp"
    }
  ]
}

🛠️ 利用可能なツール

設定が完了すると、AIアシスタントは7つの専用ツールにアクセスできます。

1. search_liquid_docs(queries: List[str])

すべてのShopify Liquidドキュメントを対象とした全文検索を行います。 例:

AI: ドキュメント内で「for loop」を検索します...

2. get_liquid_tag(tag_name: str)

特定のタグの完全なドキュメントを取得します。 例:

AI: 「for」タグのドキュメントを取得します...

3. get_liquid_filter(filter_name: str)

特定のフィルターの完全なドキュメントを取得します。 例:

AI: 「upcase」フィルターのドキュメントを検索します...

4. get_liquid_object(object_name: str)

特定のオブジェクトの完全なドキュメントを取得します。 例:

AI: 「product」オブジェクトのプロパティを確認します...

5. list_liquid_tags()

カテゴリ別に整理された30の利用可能なタグを一覧表示します。

6. list_liquid_filters()

カテゴリ別に整理された101の利用可能なフィルターを一覧表示します。

7. list_liquid_objects()

カテゴリ別に整理された67の利用可能なオブジェクトを一覧表示します。

💬 クエリの例

AIアシスタントに以下のような質問を試してみてください。

ドキュメントの取得

• 「forループタグのドキュメントを表示して」
• 「Liquidのmoneyフィルターはどのように動作するか？」
• 「productオブジェクトにはどのようなプロパティがあるか？」

検索

• 「カート機能に関するドキュメントを検索して」
• 「日付に関連するすべてのフィルターを見つけて」
• 「コレクションに使用できるオブジェクトは何か？」

一覧表示

• 「すべてのShopify Liquidタグを一覧表示して」
• 「利用可能なすべての文字列フィルターを表示して」
• 「利用可能な反復タグは何か？」

構築

• 「商品をグリッドで表示するのを手伝って」
• 「Liquidで日付をフォーマットする方法は？」
• 「カートを操作する方法を教えて」

📊 ドキュメントのカバレッジ

完全なリファレンス

• 30のLiquidタグ

  • 制御フロー: if, unless, case, else
  • 反復: for, break, continue, cycle, tablerow, paginate
  • 変数: assign, capture, increment, decrement, echo
  • テーマ: layout, section, sections, render, include, content_for
  • HTML/アセット: form, style, stylesheet, javascript
  • 構文: comment, raw, liquid, doc

• 101のLiquidフィルター

  • 文字列 (24): upcase, downcase, capitalize, append, prepend, など
  • 配列 (13): join, sort, reverse, map, where, size, など
  • 数学 (11): plus, minus, times, divided_by, modulo, など
  • 通貨 (4): money, money_with_currency, など
  • 画像 (5): image_url, image_tag, など
  • 色 (9): color_darken, color_lighten, など
  • その他...

• 67のLiquidオブジェクト

  • ストア: shop, settings, theme, brand
  • 商品: product, variant, collection, collections
  • カート: cart, line_item, checkout
  • 顧客: customer, address, company
  • コンテンツ: page, blog, article, comment
  • メディア: image, video, media, model
  • その他...

🐳 Dockerの使用方法

クイックスタート

# イメージをビルドする
docker build -t shopify-liquid-mcp .

# サーバーを起動する
docker run -it --rm shopify-liquid-mcp

# 永続的なデータで起動する
docker run -it --rm -v mcp-data:/data shopify-liquid-mcp

docker-composeを使用する

# サーバーを起動する
docker-compose up -d

# ログを表示する
docker-compose logs -f

# サーバーを停止する
docker-compose down

# シェルアクセス
docker-compose exec shopify-liquid-mcp bash

カスタムドキュメント

独自のプロジェクト固有のLiquidドキュメントを追加します。

# カスタムドキュメントディレクトリを作成する
mkdir custom-docs

# .mdファイルを追加する
cp my-snippets.md custom-docs/

# docker-compose.ymlにマウントする
volumes:
  - ./custom-docs:/docs/custom:ro

🔧 開発

テストの実行

# すべてのテストを実行する
pytest

# 特定のテストを実行する
pytest tests/test_ingest.py

# カバレッジを含めて実行する
pytest --cov=shopify_liquid_mcp

手動テスト

# サーバーをテストする
python test_server.py

# インデックスをテストする
python -m shopify_liquid_mcp.ingest

# データベースを確認する
sqlite3 ~/.mcp/shopify-liquid-docs/database.db "SELECT COUNT(*) FROM liquid_docs;"

ドキュメントの再インデックス化

# 強制的に再インデックス化する
python -m shopify_liquid_mcp.ingest --force

# カスタムデータベースの場所を指定する
SHOPIFY_LIQUID_DB_PATH=/custom/path/db.sqlite python -m shopify_liquid_mcp.ingest

📚 ドキュメント

• インストールガイド
• VS Codeのセットアップ
• Dockerガイド
• コントリビュートガイド
• サンプル
• APIリファレンス

🤝 コントリビュート

コントリビューションを歓迎します！コントリビュートガイドを読んでから、ご協力いただけると幸いです。

クイックスタート

# フォークしてクローンする
git clone https://github.com/florinel-chis/shopify-liquid-mcp.git
cd shopify-liquid-mcp

# 仮想環境を作成する
python -m venv venv
source venv/bin/activate  # または、Windowsの場合は `venv\Scripts\activate`

# 開発用にインストールする
pip install -e ".[dev]"

# テストを実行する
pytest

# 変更を加えてPRを送信する

📄 ライセンス

このプロジェクトはMITライセンスの下で公開されています。詳細はLICENSEファイルを参照してください。

🙏 謝辞

• Gemini API Docs MCPにインスパイアされています。
• FastMCPを使用して構築されています。
• ドキュメントはShopify Liquid APIから取得されています。
• MCPプロトコルはAnthropicによって提供されています。

🔗 関連プロジェクト

• 公式Shopify Dev MCP - Shopify APIの開発に使用します。
• FastMCP - MCPサーバーのフレームワークです。
• Model Context Protocol - MCPの仕様です。

📞 サポート

• 🐛 Issues
• 💬 Discussions
• 📧 Email

⭐ スター履歴

Shopifyテーマ開発コミュニティのために愛を込めて作られました