XTBApi서버
@sharplygroup/xtb-api-js 라이브러리를 사용하여 XTB API를 제공하는 MCP 서버입니다. 모델 컨텍스트 프로토콜(Model Context Protocol)을 통해 XTB 거래 계좌와 상호 작용할 수 있습니다.
필수 조건
Node.js(버전 16 이상)
엔피엠
XTB 거래 계좌
Related MCP server: xrpl-mcp-service
설치
이 저장소를 복제하세요: git clone [repository_url]
프로젝트 디렉토리로 이동합니다: cd xtb-mcp-server
종속성 설치: npm install
구성
프로젝트 디렉토리에
.env파일을 만들고 XTB API 자격 증명을 추가합니다.
지엑스피1
참고: your_user_id 와 your_password 실제 XTB API 사용자 인증 정보로 바꾸세요. 라이브 계정을 사용하는 경우 DEMO_ACCOUNT false 로 설정하세요.
서버 실행
TypeScript 코드를 빌드합니다: npm run build
서버를 실행합니다: node build/index.js
MCP 클라이언트와 연결
MCP Inspector와 같은 MCP 클라이언트를 사용하여 이 서버에 연결할 수 있습니다.
MCP Inspector를 전역적으로 설치합니다: npm install -g @modelcontextprotocol/inspector
서버로 MCP Inspector를 실행합니다: npx @modelcontextprotocol/inspector node build/index.js
MCP Inspector UI에서 전송 유형으로 "stdio"를 선택하고 "연결"을 클릭합니다.
사용 가능한 도구
이 MCP 서버는 다음과 같은 도구를 제공합니다.
계정 운영
getCurrentUserData : 계정 통화 및 계정 레버리지에 대한 정보를 반환합니다.
getMarginLevel : 다양한 계정 지표를 반환합니다.
계산 작업
getCommissionDef : 수수료와 환율을 계산한 값을 반환합니다.
매개변수:
symbol(문자열),volume(숫자)
getMarginTrade : 주어진 상품과 거래량에 대한 예상 마진을 반환합니다.
매개변수:
symbol(문자열),volume(숫자)
getProfitCalculation : 주어진 거래 데이터에 대한 예상 수익을 계산합니다.
매개변수:
closePrice(숫자),cmd(숫자),openPrice(숫자),symbol(문자열),volume(숫자)
시장 데이터 운영
getCalendar : 시장 이벤트가 포함된 달력을 반환합니다.
getChartLastRequest : 시작 날짜부터 현재 시간까지의 차트 정보를 반환합니다.
매개변수:
info(any)
getChartRangeRequest : 지정된 시작 및 종료 날짜 사이의 데이터가 포함된 차트 정보를 반환합니다.
매개변수:
info(any)
getTickPrices : 주어진 심볼에 대한 현재 견적 배열을 반환합니다. 주어진 타임스탬프를 기준으로 변경된 견적만 반환됩니다.
매개변수:
level(숫자),symbols(문자열[]),timestamp(숫자)
getTradingHours : 견적과 거래 시간을 반환합니다.
매개변수:
symbols(문자열[])
뉴스 운영
getNews : 지정된 기간 내에 거래 서버에서 전송된 뉴스를 반환합니다.
매개변수:
end(숫자),start(숫자)
서버 운영
getServerTime : 거래 서버의 현재 시간을 반환합니다.
getVersion : 현재 API 버전을 반환합니다.
ping : 이 함수를 정기적으로 호출하면 시스템의 모든 구성 요소의 내부 상태를 새로 고치는 데 충분합니다.
심볼 연산
getAllSymbols : 사용자가 사용할 수 있는 모든 심볼의 배열을 반환합니다.
getSymbol : 사용자가 사용할 수 있는 심볼에 대한 정보를 반환합니다.
매개변수:
symbol(문자열)
무역 운영
getTrades : 사용자의 거래 배열을 반환합니다.
매개변수:
openedOnly(부울)
getTradeRecords :
orders인수에 나열된 거래 배열을 반환합니다.매개변수:
orders(숫자[])
getTradesHistory : 지정된 기간 내에 종료된 사용자 거래의 배열을 반환합니다.
매개변수:
end(숫자),start(숫자)
getTradeStatus : 현재 거래 상태를 반환합니다.
매개변수:
order(숫자)
거래 운영
tradeTransaction : 거래 거래를 시작합니다.
매개변수:
tradeTransInfo(모든)
tradeTransactionStatus : 현재 거래 상태를 반환합니다.
매개변수:
order(숫자)
명령 실행
executeCommand : 서버에서 명령을 실행합니다.
매개변수:
command(문자열)
프롬프트
다음과 같은 프롬프트를 사용할 수 있습니다.
getAccountDataPrompt : 현재 계좌 데이터를 가져옵니다.
getSymbolInfoPrompt : 특정 심볼에 대한 정보를 가져옵니다.
매개변수:
symbol(문자열)
부인 성명
이 MCP 서버는 예시로 제공되며, 사용에 따른 모든 책임은 사용자에게 있습니다. 실제 거래 계좌에서 이 서버를 사용하기 전에 XTB API와 관련된 잠재적 위험을 반드시 이해하시기 바랍니다.