Cursor에서 금 시세 조회

goldprice.dev MCP 서버로 Cursor에서 금, 은, 구리 시세를 조회하세요. API 키를 사용하는 로컬 연결이나 키 없는 원격 연결을 선택할 수 있습니다. 유료 플랜은 실시간 시세를 제공하며, Free와 키 없는 연결의 시세는 지연됩니다.

• 로컬 설정에는 Node.js와 goldprice.dev API 키가 필요합니다.
• 원격 설정에는 Node.js나 API 키가 필요 없습니다.
• Cursor에 표시되는 각 도구 호출을 승인할 수 있습니다.

로컬 설정용 무료 API 키 발급

goldprice.dev에 가입하면 신용카드 없이 무료 API 키를 발급받을 수 있습니다. Free는 월 5,000회 호출과 분당 10회 요청을 지원합니다.

npx로 로컬 서버를 실행할 수 있도록 Node.js를 설치하세요. Node.js 설치나 키 발급 없이 연결하려면 아래의 원격 설정을 따르세요.

Cursor에 로컬 서버 추가

저장소 루트의 .cursor/mcp.json 또는 ~/.cursor/mcp.json을 여세요. mcpServers 아래에 goldprice 항목을 추가하세요. npx로 @nusantara-ventures/goldprice-mcp를 실행합니다.

env 블록의 GP_KEY 값에서 YOUR_API_KEY를 발급받은 키로 바꾸세요. mcp.json을 수정한 뒤 사용자 지정에서 서버를 껐다 켜거나 Cursor를 다시 시작하세요.

{  "mcpServers": {    "goldprice": {      "command": "npx",      "args": [        "-y",        "@nusantara-ventures/goldprice-mcp"      ],      "env": {        "GP_KEY": "YOUR_API_KEY"      }    }  }}

원격 서버로 연결

mcp.json의 mcpServers 아래에 원격 goldprice 항목을 추가하세요. https://api.goldprice.dev/v1/mcp/ 를 사용하고 끝의 슬래시를 유지하세요. mcp.json을 수정한 뒤 Cursor를 다시 시작하거나 사용자 지정에서 서버를 껐다 켜세요.

Node.js나 키가 필요 없습니다. 키 없이 get_spot_price, list_commodities, get_carat, search_docs, get_metadata 및 get_historical 도구를 사용할 수 있습니다. get_physical_price와 get_forward_view는 plan_gated 오류를, start_checkout은 api_key_required를 반환합니다. 시세는 15분 지연됩니다.

키 없이 get_historical로 30일간의 일별 내역을 조회할 수 있으며, 더 긴 내역은 유료 플랜이 필요합니다. get_metadata도 키 없이 사용할 수 있습니다. 로컬 연결에 유료 키를 설정하면 실시간 시세를 제공합니다.

{  "mcpServers": {    "goldprice": {      "url": "https://api.goldprice.dev/v1/mcp/"    }  }}

Cursor에 시세 물어보기

Cursor의 채팅이나 에이전트 패널에서 물어보세요. Cursor에 각 도구 호출이 표시되며, 결과를 작업에 사용하기 전에 승인할 수 있습니다.

"INR 기준 22K 금의 g당 가격은 얼마인가요?"라고 물으면 get_carat을 사용합니다. 로컬 서버와 키 없는 원격 연결 모두에서 사용할 수 있습니다.

"지난달 은의 일별 종가를 조회해주세요"라고 요청하면 get_historical을 사용합니다. 키 없이 30일간 조회할 수 있으며, 더 긴 내역은 유료 플랜이 필요합니다.

Cursor에서 조회할 수 있는 정보

키 없는 원격 연결은 get_spot_price, list_commodities, get_carat, search_docs, get_metadata 및 get_historical 도구를 지원하며, 30일간의 일별 내역도 조회할 수 있습니다.

일중 봉 데이터는 Plus 또는 Pro가 필요합니다. get_physical_price로 판매점 가격을 조회하려면 Basic 이상이 필요합니다. get_forward_view는 기존 플랜 전용입니다.

제공되는 가격은 참조 가격이며 거래 제안이 아닙니다. 플랜 구매에는 start_checkout을 사용하며 사용자의 확인이 필요합니다.

문제 해결

도구가 나타나지 않으면 mcp.json에서 마지막 항목 뒤의 쉼표 등 JSON 오류를 확인하세요. mcp.json을 수정한 뒤 사용자 지정에서 서버를 껐다 켜거나 Cursor를 다시 시작하세요.

invalid_api_key 오류는 키가 잘못되었거나 누락되었다는 뜻입니다. 로컬 항목의 env 블록에 GP_KEY가 있고 YOUR_API_KEY를 발급받은 키로 바꿨는지 확인하세요.