금속 가격 MCP 서버

GoldAPI.io 서비스를 통해 현재 및 과거 금/귀금속 가격을 제공하는 MCP 서버입니다.

특징

• 금(XAU), 은(XAG), 백금(XPT), 팔라듐(XPD)의 현재 가격을 알아보세요.

• 여러 통화 지원(USD, EUR 등)

• 날짜별 선택적 과거 가격 조회

Related MCP server: Frankfurter Forex MCP

요구 사항

• 파이썬 3.7 이상

• 패키지:

  • mcp>=1.0.0

  • requests>=2.31.0

설정

1. 이 저장소를 복제하세요

2. 종속성 설치:

   지엑스피1

3. GoldAPI.io API 키를 환경 변수로 설정합니다.

   export GOLDAPI_API_KEY="your_api_key_here"

   (Windows 사용자: export 대신 set 사용하세요)

용법

서버는 하나의 MCP 도구를 제공합니다.

설치

이 서버는 cline_mcp_settings.json 파일에 구성을 추가하여 수동으로 설치하도록 설계되었습니다.

1. cline_mcp_settings.json 파일의 mcpServers 개체에 다음 항목을 추가합니다.

"mcp_metal_price": {
  "args": [
    "/c",
    "python",
    "-m",
    "mcp_metal_price"
  ],
  "env": {
    "GOLDAPI_API_KEY": "Your GOLDAPI_API_KEY"
  }
}

금값 알아보기

현재 또는 과거 금속 가격을 알아보세요.

매개변수:

• currency (문자열, 기본값: "USD"): 통화 코드(ISO 4217 형식)

• metal (문자열, 기본값: "XAU"): 금속 기호(XAU, XAG, XPT, XPD)

• date (문자열, 선택 사항): YYYYMMDD 형식의 과거 날짜

사용 예:

{
  "currency": "EUR",
  "metal": "XAU"
}

서버 실행

다음을 사용하여 서버를 시작합니다.

python src/server.py

MCP 클라이언트와 함께 사용

서버가 실행되면 Cline이나 Claude와 같은 MCP 클라이언트에서 서버에 연결할 수 있습니다.

서버에 연결

서버는 기본적으로 stdio에서 실행됩니다. MCP 클라이언트에서는 다음을 사용하여 연결할 수 있습니다.

cmd /c python src/server.py

get_gold_price 도구 사용

Cline/Claude의 도구 사용 예:

<use_mcp_tool>
<server_name>gold-price</server_name>
<tool_name>get_gold_price</tool_name>
<arguments>
{
  "currency": "USD",
  "metal": "XAU"
}
</arguments>
</use_mcp_tool>

응답 형식

서버는 JSON 형식으로 가격 데이터를 반환합니다.

{
  "timestamp": 1713600000,
  "metal": "XAU",
  "currency": "USD",
  "price": 2345.67,
  "unit": "per troy ounce"
}

특허

이 프로젝트는 MIT 라이선스 조건에 따라 라이선스가 부여됩니다. 자세한 내용은 라이선스 파일을 참조하세요.