使用说明
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
