Shopify MCP服务器

一个基于Python的Shopify MCP服务器实现,提供与Shopify API交互的功能,包括GraphQL API支持、文档搜索和代码验证。

  • by A-baoYang
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 A-baoYang/shopify-python-mcp-server

使用说明

Shopify MCP服务器-Python实现

这是使用FastMCP的Shopify MCP服务器的Python实现。它提供了与原始TypeScript版本相同的功能,帮助开发人员通过模型上下文协议与Shopify API进行交互。

灵感来自 shopify.dev mcp服务器

特性

  • 管理GraphQL API 支持模式自检和验证
  • 文档搜索 跨shopify.dev
  • GraphQL代码验证 防止产生幻觉
  • 对话跟踪 用于使用情况分析
  • 架构缓存 为了提高性能

安装

# Clone the repository
git clone https://github.com/A-baoYang/shopify-python-mcp-server
cd shopify-mcp-server

# Install dependencies using uv
uv pip install -r requirements.txt

# Or install with pip
pip install -r requirements.txt

用法

运行服务器

# Using uv
uv run python main.py

# Or with Python directly
python main.py

Claude桌面或光标的配置

将以下内容添加到MCP配置中:

{
  "mcpServers": {
    "shopify-mcp-server": {
      "command": "python",
      "args": ["/path/to/shopify-mcp-server/main.py"]
    }
  }
}

紫外线:

{
  "mcpServers": {
    "shopify-mcp-server": {
      "command": "uv",
      "args": ["run", "python", "/path/to/shopify-mcp-server/main.py"]
    }
  }
}

环境变量

  • OPT_OUT_INSTRUMENTATION:设置为 "true" 禁用使用情况跟踪
  • POLARIS_UNIFIED:设置为 "true" 或 "1" 启用Polaris支持
  • LIQUID_MCP:设置为 "true" 或 "1" 启用液体支持(实验)
  • DEV:设置为 "true" 使用Shopify URL进行开发

可用工具

工具名称 描述
learn_shopify_api 先从这里开始 -教授Shopify API并生成所需的对话ID
search_docs_chunks 在shopify.dev文档中搜索
fetch_full_docs 检索完整的文档页面
introspect_graphql_schema 探索GraphQL模式以查找类型、查询和突变
validate_graphql_codeblocks 根据架构验证GraphQL代码

可用提示

提示名称 描述
shopify_admin_graphql 帮助编写Shopify Admin API的GraphQL操作

发展

项目结构:

shopify-mcp-server/
--- main.py              # Main server entry point
--- src/
|   --- settings.py      # Configuration settings
|   --- types.py         # Type definitions
|   --- tools/           # Tool implementations
|   --- validations/     # Validation logic
|   --- utils/           # Utility functions
--- data/                # Schema cache directory