AI导哈

Shopify MCP服务器

一个Python实现的模型上下文协议（MCP）服务器，使Claude AI能够无缝地与Shopify商店数据进行交互，提供更智能和上下文相关的电子商务任务协助。

  • by abhi-mahule
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 abhi-tapestry/shopify-mcp-server

使用说明

适用于Claude的Python Shopify MCP服务器

模型上下文协议（MCP）服务器的Python实现，使Claude AI能够与您的Shopify商店数据无缝交互。通过这种集成，Claude可以访问产品目录、客户信息和订单详细信息，为电子商务任务提供更智能和情境化的帮助。

🌟 特性

  • 无缝集成Claude

    • 在Claude对话中直接访问您的Shopify商店数据
    • 无需复制粘贴数据或在应用程序之间切换
    • Claude可以分析和推理您的店铺信息

  • 完整的产品访问权限

    • 查询您的整个产品目录
    • 访问详细的产品信息、变体和库存
    • 按标题、供应商或产品类型搜索产品

  • 客户洞察

    • 检索客户资料和购买历史记录
    • 访问联系信息和送货地址
    • 查看支出模式和订单频率

  • 订单管理

    • 访问订单详细信息、行项目和履行状态
    • 查看付款信息和运输详细信息
    • 分析订单指标和模式

  • 商店信息

    • 访问有关Shopify商店的元数据
    • 查看货币、地区和时区设置
    • 检索店主和业务详细信息

📋 先决条件

  • Python 3.10或更高版本（推荐使用Python 3.12）
  • 具有管理员API访问凭据的Shopify商店
  • 克劳德桌面 安装
  • 对终端命令的基本理解

🚀 快速开始

1.克隆存储库

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

2.设置Python环境

创建并激活虚拟环境：

# Create virtual environment
python -m venv .venv-py312

# Activate on macOS/Linux
source .venv-py312/bin/activate

# Activate on Windows
.venv-py312\Scripts\activate

3.安装依赖项

pip install ShopifyAPI fastmcp python-dotenv

4.配置Shopify凭据

创建一个 .env 项目根目录中的文件：

SHOPIFY_SHOP_URL=your-store.myshopify.com
SHOPIFY_ACCESS_TOKEN=your_access_token_here

或者对于API密钥验证：

SHOPIFY_SHOP_URL=your-store.myshopify.com
SHOPIFY_API_KEY=your_api_key_here
SHOPIFY_PASSWORD=your_private_app_password_here

或者，您可以使用安装脚本进行更安全的配置：

chmod +x setup_credentials.sh
./setup_credentials.sh

5.测试您的配置

通过运行以下命令验证您的设置：

chmod +x test_env.sh
./test_env.sh

6.使服务器可执行

chmod +x claude_server.sh

🔧 配置Claude桌面

要将Shopify MCP服务器添加到Claude Desktop，请执行以下操作：

  1. 打开Claude Desktop并单击设置图标

  2. 在MCP设置部分，使用以下设置添加新服务器：

    • 名称：Shopify商店
    • 命令：/full/path/to/shopify mcp服务器/claude_server.sh
    • 工作目录：/full/path/to/shopify mcp服务器

    确保更换 /full/path/to/ 使用您的实际文件路径。

  3. 保存配置并重新启动Claude Desktop

  4. Claude现在应该可以访问您的Shopify商店数据了！

🧠 与Claude一起使用Shopify工具

配置后，您可以要求Claude在对话中使用Shopify工具。以下是一些示例：

  • “给我看看我店里排名前5的产品”
  • “查找所有花费超过100美元的客户”
  • “搜索供应商X生产的产品”
  • “获取我最近订单的详细信息”
  • “我目录中产品的平均价格是多少？”

Claude将通过MCP服务器访问您的Shopify数据，并根据您的实际店铺信息提供有见地的回复。

🔒 安全最佳实践

  • 凭证保护：使用受限文件权限存储API凭据（600）
  • 只读访问：MCP服务器仅检索数据，无法修改您的存储
  • 最低程度的接触：以最少的权限配置您的Shopify API访问权限
  • 仅限本地：服务器在您的计算机上本地运行，以实现最大的安全性
  • 凭证轮换：定期轮换API密钥和令牌

❓ 故障排除

如果您遇到Shopify MCP服务器问题：

  1. 检查您的凭据

    • 验证您的Shopify API凭证在您的 .env 文件
    • 确保您的店铺URL格式正确（例如。， your-store.myshopify.com)

  2. 验证克劳德桌面配置

    • 确保Claude Desktop设置中的路径是绝对正确的
    • 检查工作目录是否设置正确
    • 更改配置后重新启动Claude Desktop

  3. 检查服务器执行情况

    • 确保 claude_server.sh 可执行
    • 如果遇到权限问题，请运行 chmod +x claude_server.sh

有关更详细的设置信息，请参阅 CLAUDE_SETUP.md 文件。

📚 可用的MCP工具

Shopify MCP服务器为Claude提供了以下功能：

工具 说明
get_products 从您的Shopify商店检索产品列表
get_product_details 获取特定产品的详细信息
get_customers 从您的商店检索客户列表
get_customer_details 获取特定客户的详细信息
get_orders 从您的商店检索订单列表
search_products 按名称、类型或供应商搜索产品
get_store_info 获取有关Shopify商店的信息

🏗️ 项目结构

  • shopify_mcp_fastmcp.py -使用FastMCP实现主Python MCP服务器
  • claude_server.sh -为Claude启动Python MCP服务器的Bash脚本
  • setup_credentials.sh -用于安全凭据配置的辅助脚本
  • test_env.sh -用于验证环境设置的诊断工具
  • .env.example -示例环境变量文件
  • CLAUDE_SETUP.md -Claude Desktop的详细设置说明

🧪 技术栈

  • python：核心实现语言（3.10+兼容，推荐3.12）
  • FastMCP：用于高效MCP实现的Python库
  • Shopify API：Shopify API集成的官方Python客户端
  • Python dotenv：用于安全的环境变量管理

🌐 了解更多信息

📄 许可证

MIT许可证

🤝 贡献

欢迎投稿！请随时提交拉取请求。

  1. 分叉存储库
  2. 创建功能分支(git checkout -b feature/amazing-feature)
  3. 提交您的更改(git commit -m 'Add some amazing feature')
  4. 推到分支(git push origin feature/amazing-feature)
  5. 打开拉取请求

📬 联系

如果您有任何问题或需要设置帮助，请在GitHub存储库上打开问题。

Made with ❤️ for Claude and Shopify enthusiasts

相关 MCP