금속 가격 MCP 서버
GoldAPI.io 서비스를 통해 현재 및 과거 금/귀금속 가격을 제공하는 MCP 서버입니다.
특징
- 금(XAU), 은(XAG), 백금(XPT), 팔라듐(XPD)의 현재 가격을 알아보세요.
- 여러 통화 지원(USD, EUR 등)
- 날짜별 선택적 과거 가격 조회
요구 사항
- 파이썬 3.7 이상
- 패키지:
mcp>=1.0.0
requests>=2.31.0
설정
- 이 저장소를 복제하세요
- 종속성 설치:지엑스피1
- GoldAPI.io API 키를 환경 변수로 설정합니다.
export GOLDAPI_API_KEY="your_api_key_here"
(Windows 사용자: export
대신 set
사용하세요)
용법
서버는 하나의 MCP 도구를 제공합니다.
설치
이 서버는 cline_mcp_settings.json
파일에 구성을 추가하여 수동으로 설치하도록 설계되었습니다.
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"
}
서버 실행
다음을 사용하여 서버를 시작합니다.
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 라이선스 조건에 따라 라이선스가 부여됩니다. 자세한 내용은 라이선스 파일을 참조하세요.