@更强大的电子商务/小工具mcp
通用只读MCP服务器,适用于任何 小工具 应用程序。 通过GraphQL自省查询任何模型——不需要生成客户端。
由...建造 更强大的电子商务.
______________________________________________________________________
快速设置(推荐)
从Gadget项目目录中运行交互式安装向导。 它会自动检测您的应用程序 .gadget/sync.json 并自动写入您的配置。
npx @stronger-ecommerce/gadget-mcp setup向导将:
- 从以下位置检测您的应用程序slug
.gadget/sync.json(如果存在) - 提示输入API密钥和环境
- 输出准备运行
claude mcp add克劳德代码命令 - 自动写入您的
~/.cursor/mcp.json对于光标
______________________________________________________________________
手动设置
1.获取生产API密钥
首选 https://.gadget.app/edit/settings/api-keys 并创建具有读取权限的密钥。
2.在克劳德代码中注册
claude mcp add my-app-gadget \
-e GADGET_APP=my-app \
-e GADGET_API_KEY=your_key_here \
-- npx @stronger-ecommerce/gadget-mcp以不同名称注册多个应用程序:
claude mcp add app-one-gadget \
-e GADGET_APP=my-first-app \
-e GADGET_API_KEY=key1 \
-- npx @stronger-ecommerce/gadget-mcp
claude mcp add app-two-gadget \
-e GADGET_APP=my-second-app \
-e GADGET_API_KEY=key2 \
-- npx @stronger-ecommerce/gadget-mcp3.在游标中注册
添加 ~/.cursor/mcp.json:
{
"mcpServers": {
"app-one-gadget": {
"command": "npx",
"args": ["@stronger-ecommerce/gadget-mcp"],
"env": {
"GADGET_APP": "my-first-app",
"GADGET_API_KEY": "key1"
}
},
"app-two-gadget": {
"command": "npx",
"args": ["@stronger-ecommerce/gadget-mcp"],
"env": {
"GADGET_APP": "my-second-app",
"GADGET_API_KEY": "key2"
}
}
}
}______________________________________________________________________
环境变量
| 变量 | 必填 | 默认 | 描述 |
|---|---|---|---|
GADGET_APP | 是 | -- | 应用程序段塞,例如。 my-app |
GADGET_API_KEY | 是 | - | 生产API密钥 |
GADGET_ENVIRONMENT | 没有 | production | production 或 development |
______________________________________________________________________
工具
| 工具 | 说明 |
|---|---|
list_models | 列出应用程序中可用的所有型号 |
introspect_model | 显示模型的字段和类型 |
query_records | 使用过滤器和字段选择查询任何模型 |
get_record | 按ID获取单个记录 |
run_graphql | 运行原始只读GraphQL查询(阻止突变) |
______________________________________________________________________
示例用法
连接后,问克劳德:
- *“列出我的小工具应用程序中的模型”*
- *“显示shopifyOrder模型上的字段”*
- *“查找电子邮件所在的订单customer@example.com"*
- *“获取所有有错误的记录”*
______________________________________________________________________
未来功能
计划的想法和研究笔记(包括日志/ ggt 代理集成) FUTURE_FEATURES.md.
______________________________________________________________________
贡献
欢迎Bug报告和拉取请求!
- 发现bug了吗? 打开一个问题
- 有修复或功能吗? 分叉仓库,进行更改,然后打开一个PR
main - 对于重大更改,请先打开一个问题,以便我们能够在方法上保持一致
在本地运行
git clone https://github.com/Stronger-eCommerce/gadget-mcp
cd gadget-mcp
npm install
npm run build
npm test______________________________________________________________________
关于
制作♥ 通过 更强大的电子商务 --Shopify开发和电子商务运营。
