@stronger-ecommerce/gadget-mcp

Name: Gadget MCP Server
Author: Stronger-eCommerce

모든 Gadget 앱을 위한 범용 읽기 전용 MCP 서버입니다. 생성된 클라이언트 없이도 GraphQL 인트로스펙션을 통해 모든 모델을 쿼리할 수 있습니다.

빠른 설정 (권장)

Gadget 프로젝트 디렉토리 내에서 대화형 설정 마법사를 실행하세요. .gadget/sync.json에서 앱 슬러그를 자동으로 감지하고 설정을 자동으로 작성합니다.

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에서 확인할 수 있습니다.

기여하기

버그 리포트와 풀 리퀘스트를 환영합니다!

버그를 발견하셨나요? 이슈를 열어주세요
수정 사항이나 기능이 있나요? 리포지토리를 포크하고 변경 사항을 적용한 뒤 main 브랜치로 PR을 열어주세요.
중요한 변경 사항의 경우, 접근 방식을 맞추기 위해 먼저 이슈를 열어주세요.

로컬에서 실행하기

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