@stronger-ecommerce/gadget-mcp

Name: Gadget MCP Server
Author: Stronger-eCommerce

适用于任何 Gadget 应用的通用只读 MCP 服务器。通过 GraphQL 内省查询任何模型 — 无需生成客户端。

快速设置（推荐）

在你的 Gadget 项目目录中运行交互式设置向导。它会自动从 .gadget/sync.json 检测你的应用标识（slug）并自动写入配置。

npx @stronger-ecommerce/gadget-mcp setup

该向导将：

从 .gadget/sync.json 检测你的应用标识（如果存在）
提示输入你的 API 密钥和环境
输出适用于 Claude Code 的 claude mcp add 就绪命令
自动为 Cursor 写入 ~/.cursor/mcp.json

手动设置

1. 获取生产环境 API 密钥

前往 https://<your-app>.gadget.app/edit/settings/api-keys 并创建一个具有读取权限的密钥。

2. 在 Claude Code 中注册

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-mcp

3. 在 Cursor 中注册

添加到 ~/.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 查询（禁止变更操作）

使用示例

连接后，询问 Claude：

“列出我 Gadget 应用中的模型”
“向我展示 shopifyOrder 模型上的字段”
“查找电子邮件为 customer@example.com 的订单”
“获取所有带有错误的记录”

未来功能

计划中的想法和研究笔记（包括日志 / ggt 代理集成）位于 FUTURE_FEATURES.md。

贡献

欢迎提交错误报告和拉取请求！

发现错误？ 提交一个 issue
有修复或新功能？ Fork 本仓库，进行更改，并针对 main 分支提交 PR
对于重大更改，请先提交 issue，以便我们对方案达成一致

本地运行

git clone https://github.com/Stronger-eCommerce/gadget-mcp
cd gadget-mcp
npm install
npm run build
npm test

关于

由 Stronger eCommerce 用 ♥ 制作 — Shopify 开发与电子商务运营。

Install Server

A

security – no known vulnerabilities

F

license - not found

A

quality - A tier

How are these scores calculated?

Resources

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Gadget MCP Server