Skip to main content
Glama
keumbang/goldpopcon-openapi-mcp

keumbang/goldpopcon-openapi-mcp

@keumbang/goldpopcon-openapi-mcp

npm CI node license

골드팝콘(금방) Open API MCP-Server für Codierungsassistenten. Er hilft, präzisen Code für die Integration von Gold- und Silberhandels-APIs zu schreiben, wenn er an MCP-Clients wie Claude Code, Claude Desktop, Codex CLI, Gemini CLI, Cursor usw. angeschlossen wird.

API-Schlüssel beantragen

Open-API-Schlüssel (gpk_ Zugriffsschlüssel + sk_ geheimer Schlüssel) werden nur in der Gold Popcorn App ausgestellt. Es gibt keinen Weg zur Ausstellung über das Web.

  1. Gold Popcorn App installieren — App Store · Google Play

  2. Nach der Registrierung Schlüssel im Open-API-Menü der App ausstellen.

  3. Der sk_ geheime Schlüssel wird nur auf dem Ausstellungsbildschirm angezeigt — bewahren Sie ihn sofort an einem sicheren Ort auf.

Der Punkt, an dem Entwickler bei dieser API hängen bleiben, sind nicht die Feldnamen, sondern die Anfragesignatur — die query_hash-Eingabe variiert je nach Methode (POST=roher Body, GET=normalisierte Query-String) und wenn man das Upbit-Beispiel direkt übernimmt, erhält man überall 401. Dieser MCP generiert diesen Prozess als Code und führt die Signatur/Verifizierung lokal durch.

Related MCP server: korea-stock-mcp

Werkzeuge

Werkzeug

Zweck

list_endpoints

Liste der Endpunkte — inklusive Berechtigungsbereiche, Idempotenz, Rate-Buckets

get_endpoint

Details eines einzelnen Endpunkts — Parameter, Body-Schema, Beispiele für Anfrage/erfolgreiche Antwort, Antwortcodes

list_error_codes

Fehlercodetabelle + Wiederholungsentscheidung nach Statuscode + Fallstricke (Kontostand unzureichend=400 P0001, Authentifizierungsfehler=401 error:null)

signing_guide

JWT-Signaturverfahren — query_hash-Verzweigung, Zeitanspruch, Nonce, Idempotenz

generate_signed_request

Generiert vollständigen signierten Anforderungscode pro Sprache (python/javascript/go/curl)

sign_request

Berechnet JWT lokal mit echtem Schlüssel (Debugging) — gibt JWT, query_hash, sofort verwendbares curl zurück

verify_signature

Überprüft bereits erstelltes JWT in derselben Reihenfolge wie der Server — Diagnose von 401-Ursachen

call_api (opt-in)

Tatsächlicher Aufruf — nur Abfrage, production fest. Wird nur registriert, wenn per env aktiviert.

Ressourcen: goldpopcon://openapi.yaml (vollständige Spezifikation), goldpopcon://overview (Prosa zu Signatur, Limits, Fehlern).

Sicherheit: Der an sign_request/verify_signature/call_api übergebene secret_key wird nur für die lokale Signatur verwendet und nur das Signaturergebnis (JWT) wird übertragen — das Secret selbst wird nicht über das Netzwerk gesendet.

call_api — Live-Aufruf nur für Abfragen

Standardmäßig deaktiviert. Wird nur registriert, wenn GOLDPOPCON_MCP_ALLOW_LIVE=true gesetzt ist. Vierfache Sicherheitsvorkehrungen blockieren Geldbewegungen grundsätzlich:

  1. Env-Gate — ohne Variable existiert das Werkzeug nicht

  2. Whitelist — nur getPrices / getBalances / getPriceHistory / getOrderPreview / getTradeHistory. buy·sell·payout·virtual-accounts sind nicht live möglich (nur Codegenerierung)

  3. Production fest — Der Server kann nicht über Argumente geändert werden. Da es sich um reine Abfragen handelt, bewegt das Lesen von Production kein Geld.

  4. GET erzwungen — Schreibmethoden blockiert

Um Geldbewegungsendpunkte tatsächlich aufzurufen, erhalten Sie den Code über generate_signed_request und führen ihn in Ihrer eigenen Entwicklungsumgebung aus.

Leseautomatisierung — Schlüssel per env

Wenn es sich um eine Automatisierung handelt, bei der das LLM wiederholt Kurse und Kontostände abfragt, lassen Sie die Argumente accessKey/secretKey weg und geben Sie sie per env. Das als Argument übergebene sk_ bleibt bei jedem Aufruf im Klartext im Modellkontext, Transkript und Client-Log.

{
  "mcpServers": {
    "goldpopcon-openapi": {
      "command": "npx",
      "args": ["-y", "@keumbang/goldpopcon-openapi-mcp"],
      "env": {
        "GOLDPOPCON_MCP_ALLOW_LIVE": "true",
        "GOLDPOPCON_ACCESS_KEY": "gpk_...",
        "GOLDPOPCON_SECRET_KEY": "sk_..."
      }
    }
  }
}

Der env-Fallback existiert nur für call_api (nur Abfragen). sign_request wurde nicht geöffnet, da es bis zur Signatur von buyAsset reichen kann — wenn geöffnet, könnte der Agent ohne menschliches Eingreifen gültige Signaturen für Geldbewegungen erstellen.

call_api antwortet auch mit structuredContent — Werte können direkt ohne Markdown-Parsing verwendet werden.

{
  "operationId": "getPrices",
  "url": "https://api.goldpopcon.com/api/open/v1/prices",
  "status": 200,
  "ok": true,
  "data": { "...": "응답 본문 JSON 그대로" },
  "rateLimit": { "limit": 600, "remaining": 599, "reset": 1730000000, "retryAfter": null }
}
  • Die Form von data variiert pro Endpunkt — das Beispiel einer erfolgreichen Antwort von get_endpoint ist die Spezifikation.

  • Auch 4xx/5xx kommen nicht als Werkzeugfehler, sondern als status/ok. Die Schleife verzweigt und verarbeitet sie.

  • Nicht-JSON-Inhalte (Gateway-HTML-Fehler usw.) kommen als raw statt data.

  • Bei 429 enthält rateLimit.retryAfter die Wartezeit in Sekunden. Quote 600/Minute, Trade 60/Minute.

Installation · Build

git clone https://github.com/keumbang/goldpopcon-openapi-mcp.git
cd goldpopcon-openapi-mcp
npm install
npm run build       # dist/ 생성
npm test            # 서명 회귀 테스트

MCP-Client-Registrierung

Clients, die mit einer CLI-Zeile verbunden werden:

# Claude Code
claude mcp add goldpopcon-openapi -- npx -y @keumbang/goldpopcon-openapi-mcp

# Codex CLI  (~/.codex/config.toml 에 기록된다. 세션에서 /mcp 로 연결 확인)
codex mcp add goldpopcon-openapi -- npx -y @keumbang/goldpopcon-openapi-mcp

Direkte Bearbeitung der Konfigurationsdatei (Claude Desktop claude_desktop_config.json, Cursor ~/.cursor/mcp.json, Gemini CLI ~/.gemini/settings.json):

{ "mcpServers": { "goldpopcon-openapi": { "command": "npx", "args": ["-y", "@keumbang/goldpopcon-openapi-mcp"] } } }

Gemini CLI interpretiert PATH instabil — wenn der Server nicht startet, ersetzen Sie command durch den absoluten Pfad, den Sie mit which npx erhalten.

Lokalen Klon ausführen:

{
  "mcpServers": {
    "goldpopcon-openapi": {
      "command": "node",
      "args": ["/절대경로/goldpopcon-openapi-mcp/dist/index.js"]
    }
  }
}

Während der Entwicklung: command: "npx", args: ["tsx", "/absoluterPfad/.../src/index.ts"].

Umgebungsvariablen

Variable

Standard

Bedeutung

GOLDPOPCON_OPENAPI_SPEC

Gebündelt spec/openapi.yaml

Pfad zur Spezifikationsdatei überschreiben

GOLDPOPCON_MCP_ALLOW_LIVE

(kein)

Wenn true, aktiviert call_api (nur Abfragen, production)

GOLDPOPCON_ACCESS_KEY

(kein)

Standardwert für call_api-Zugriffsschlüssel — wird verwendet, wenn Argument ausgelassen wird

GOLDPOPCON_SECRET_KEY

(kein)

Standardwert für call_api-geheimen Schlüssel — empfohlen für Automatisierung wiederholter Aufrufe

Beispiel-Dialoge

  • "Gib mir Code, um sellAsset in Python aufzurufen, Gold 0,5g" → generate_signed_request(operationId=sellAsset, language=python, pathParams={asset:gold}, body={quantity:0.5})

  • "Um das gesamte gehaltene Gold zu verkaufen?" → generate_signed_request(operationId=sellAsset, language=python, pathParams={asset:gold}, body={quantity:0.001, sell_all:true}) — sell_all ignoriert die angeforderte Menge und führt die gesamte verfügbare Restmenge aus.

  • "Warum gibt dieses JWT 401?" → verify_signature(token=..., secretKey=..., method=POST, rawBody=...)

  • "Was sind die Parameter des Preisverlaufs-Endpunkts?" → get_endpoint(operationId=getPriceHistory)

  • "Welcher Fehler bei unzureichendem Kontostand?" → list_error_codes — 400 P0001 (nicht 500). Die Tabelle zur Wiederholungsentscheidung nach Statuscode wird ebenfalls angezeigt.

Spezifikationssynchronisation

Die ursprüngliche Spezifikation befindet sich im Backend-Repo unter docs/openapi.yaml (außerhalb dieses Repos), und dieses Repo bündelt eine Kopie in spec/openapi.yaml. Wenn sich das Original ändert, aktualisieren Sie es, indem Sie den Pfad mit SPEC_SRC angeben:

SPEC_SRC=/path/to/<backend-repo>/docs/openapi.yaml npm run sync-spec

SPEC_SRC ist erforderlich. Wenn es weggelassen wird, wird das Original nicht gefunden und schlägt fehl — es wurde kein Standardpfad festgelegt, um den Backend-Repo-Namen nicht in diesem Repo zu hinterlassen.

Nach der Aktualisierung committen Sie spec/openapi.yaml. Wenn die Signaturregeln vom Server abweichen, wird dies von npm test (Spiegel der Server-Validierungsregeln) erkannt.

<backend-repo>/docs/openapi.yaml  ──sync-spec──▶  spec/openapi.yaml

Available Tools

7 tools
generate_signed_requestB

특정 엔드포인트를 호출하는 완결형 서명 코드를 생성한다(python/javascript/go/curl). query_hash 분기·멱등성 헤더를 메서드에 맞게 자동 반영.

Inputs: language (required), operationId (required), body, query, +3 more.

get_endpointA

단일 엔드포인트 상세 — 설명, 파라미터, 요청 본문 스키마와 예제, 응답 상태, 권한·멱등성.

Inputs: operationId (required).

list_endpointsA

금방 Open API 엔드포인트 목록. 각 항목의 권한 스코프·멱등성 필요 여부·rate limit 버킷을 함께 준다.

Inputs: openApiOnly.

list_error_codesA

금방 Open API 에러 코드 표와 함정(잔액 부족은 400 P0001, 인증 실패는 error=null 401, 503 fail-closed 등). 상태 코드별 재시도 판단표 포함.

Inputs: no named parameters.

signing_guideA

요청 서명(JWT + query_hash) 절차. 개발자가 가장 많이 막히는 지점 — 업비트 예제를 그대로 옮기면 전부 401 이 나는 이유 포함.

Inputs: no named parameters.

sign_requestB

실제 키로 요청 하나의 JWT 를 로컬 계산한다(디버깅용). secret_key 는 로컬에서만 쓰이고 어디로도 전송되지 않는다. 결과에 JWT·query_hash·바로 쓸 curl 을 준다.

Inputs: accessKey (required), secretKey (required), operationId (required), body, +4 more.

verify_signatureB

이미 만든 JWT 를 서버와 같은 순서로 로컬 검증해 401 원인을 짚는다. secret_key·전송할 본문/쿼리를 주면 query_hash 불일치까지 진단한다.

Inputs: token (required), method (required), secretKey (required), query, +1 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4/5.0

    Scored across 7 tools

    Disambiguation5/5

    Each tool serves a distinct purpose: listing endpoints, getting details, error codes, signing guide, generating signed code, local signature computation, and signature verification. No overlap in functionality.

    Naming Consistency4/5

    Most tools follow a clear verb_noun pattern (list_endpoints, get_endpoint, generate_signed_request, sign_request, verify_signature). The one deviation is 'signing_guide' which uses a gerund-noun form, but otherwise naming is uniform and predictable.

    Tool Count5/5

    With 7 tools, the server is well-scoped for its purpose: providing API endpoint discovery, error handling, and request signing utilities. Each tool earns its place without being too many or too few.

    Completeness5/5

    The tool set covers the full workflow for an OpenAPI helper: discover endpoints, understand errors, learn signing, generate signed code, debug signature issues. No obvious gaps for its intended domain.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      An MCP server that provides current and historical gold/precious metal prices (gold, silver, platinum, and palladium) via the GoldAPI.io service with support for multiple currencies.
      1
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      An MCP server that enables natural language control of Kiwoom Securities accounts through Claude Desktop. It provides tools for stock price lookup, buying and selling stocks, and analyzing portfolios or trade history via the Kiwoom REST API.
      11
      2
      MIT
    • A
      license
      C
      quality
      C
      maintenance
      Safe-by-default MCP server for the official Toss Securities Open API, providing read-only market and account data with optional order operations protected by multiple safety gates.
      27
      2
      MIT