@keumbang/goldpopcon-openapi-mcp

Servidor MCP de asistente de codificación para la API abierta de Goldpopcon (Keumbang). Se conecta a clientes MCP como Claude Code, Claude Desktop, Codex CLI, Gemini CLI, Cursor, etc., para ayudar a escribir código preciso para la integración con la API de comercio de oro y plata.

Emisión de clave API

La clave de API abierta (clave de acceso gpk_ + clave secreta sk_) se emite solo en la aplicación Goldpopcon. No hay una ruta de emisión web.

1. Instala la aplicación Goldpopcon — App Store · Google Play

2. Regístrate y emite la clave en el menú de API abierta dentro de la aplicación

3. La clave secreta sk_ solo se muestra en la pantalla de emisión — guárdala en un lugar seguro en ese momento

El punto donde los desarrolladores se atascan en esta API no es el nombre del campo, sino la firma de la solicitud — la entrada query_hash varía según el método (POST=cuerpo sin procesar, GET=querystring normalizada) y copiar el ejemplo de Upbit directamente da como resultado un 401. Este MCP genera el código para ese procedimiento y realiza la firma/verificación localmente.

Related MCP server: korea-stock-mcp

Herramientas

Recursos: goldpopcon://openapi.yaml (especificación completa), goldpopcon://overview (prosa sobre firma, límites, errores).

Seguridad: La secret_key pasada a sign_request/verify_signature/call_api se usa solo para la firma local y solo se transmite el resultado de la firma (JWT) — el secreto en sí no viaja por la red.

call_api — Llamada en vivo solo de consulta

Desactivada por defecto. Solo se registra cuando GOLDPOPCON_MCP_ALLOW_LIVE=true. Cuádruple protección para bloquear por completo las transferencias de fondos:

1. Puerta env — sin la variable, la herramienta no existe

2. Lista blanca — solo getPrices / getBalances / getPriceHistory / getOrderPreview / getTradeHistory. buy·sell·payout·virtual-accounts no están disponibles en vivo (solo generación de código)

3. Fijo en producción — no se puede cambiar el servidor con argumentos. Como es solo de consulta, leer producción no mueve fondos

4. Forzar GET — bloquea métodos de escritura

Para llamar realmente a los endpoints de transferencia de fondos, recibe el código con generate_signed_request y ejecútalo en tu propio entorno de desarrollo.

Automatización de lectura — clave por env

Si el LLM automatiza la consulta repetitiva de precios/saldos, omite los argumentos accessKey/secretKey y proporciónalos por env. La sk_ pasada como argumento queda en texto plano en el contexto del modelo, la transcripción y los registros del cliente en cada llamada.

{
  "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_..."
      }
    }
  }
}

El fallback de env solo existe para call_api (solo consulta). sign_request no se ha abierto porque puede crear firmas hasta para buyAsset — si se abriera, un agente podría generar firmas de transferencia de fondos válidas sin intervención humana.

call_api también responde con structuredContent — para usar los valores directamente sin analizar Markdown.

{
  "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 }
}

• La forma de data varía según el endpoint — el ejemplo de respuesta exitosa de get_endpoint es la especificación.

• Los errores 4xx/5xx también llegan como status/ok, no como error de herramienta. El bucle los maneja por separado.

• El cuerpo que no es JSON (errores HTML de puerta de enlace, etc.) llega como raw en lugar de data.

• Si es 429, rateLimit.retryAfter contiene los segundos de espera. Límite: 600 consultas/minuto, 60 operaciones/minuto.

Instalación · Compilación

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

Registro del cliente MCP

Clientes que se conectan con una sola línea de CLI:

# 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

Edición directa del archivo de configuración (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"] } } }

La resolución de PATH en Gemini CLI es inestable — si el servidor no arranca, cambia command por la ruta absoluta obtenida con which npx.

Ejecución con clon local:

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

Durante el desarrollo, usa command: "npx", args: ["tsx", "/ruta/absoluta/.../src/index.ts"].

Variables de entorno

Ejemplos de diálogo

• "Dame el código para llamar a sellAsset en Python, 0.5g de oro" → generate_signed_request(operationId=sellAsset, language=python, pathParams={asset:gold}, body={quantity:0.5})

• "¿Cómo vender todo el oro que tengo?" → generate_signed_request(operationId=sellAsset, language=python, pathParams={asset:gold}, body={quantity:0.001, sell_all:true}) — sell_all ignora la cantidad solicitada y ejecuta la totalidad del saldo disponible

• "¿Por qué este JWT da 401?" → verify_signature(token=..., secretKey=..., method=POST, rawBody=...)

• "¿Qué parámetros tiene el endpoint de historial de precios?" → get_endpoint(operationId=getPriceHistory)

• "Si es saldo insuficiente, ¿qué número de error es?" → list_error_codes — 400 P0001 (no 500). También muestra la tabla de decisión de reintento por código de estado

Sincronización de la especificación

La fuente original de la especificación es docs/openapi.yaml en el repositorio del backend (fuera de este repo), y este repo incluye una copia en spec/openapi.yaml. Si la fuente cambia, actualízala especificando la ruta con SPEC_SRC:

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

SPEC_SRC es obligatorio. Si se omite, no encontrará la fuente y fallará — no se ha establecido una ruta por defecto para no dejar el nombre del repositorio del backend en este repo.

Después de la actualización, confirma spec/openapi.yaml. Si las reglas de firma se desvían del servidor, npm test (que refleja las reglas de verificación del servidor) lo detectará.

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