XTBApi서버

@sharplygroup/xtb-api-js 라이브러리를 사용하여 XTB API를 제공하는 MCP 서버입니다. 모델 컨텍스트 프로토콜(Model Context Protocol)을 통해 XTB 거래 계좌와 상호 작용할 수 있습니다.

필수 조건

• Node.js(버전 16 이상)
• 엔피엠
• XTB 거래 계좌

설치

1. 이 저장소를 복제하세요: git clone [repository_url]
2. 프로젝트 디렉토리로 이동합니다: cd xtb-mcp-server
3. 종속성 설치: npm install

구성

1. 프로젝트 디렉토리에 .env 파일을 만들고 XTB API 자격 증명을 추가합니다.

지엑스피1

참고: your_user_id 와 your_password 실제 XTB API 사용자 인증 정보로 바꾸세요. 라이브 계정을 사용하는 경우 DEMO_ACCOUNT false 로 설정하세요.

서버 실행

1. TypeScript 코드를 빌드합니다: npm run build
2. 서버를 실행합니다: node build/index.js

MCP 클라이언트와 연결

MCP Inspector와 같은 MCP 클라이언트를 사용하여 이 서버에 연결할 수 있습니다.

1. MCP Inspector를 전역적으로 설치합니다: npm install -g @modelcontextprotocol/inspector
2. 서버로 MCP Inspector를 실행합니다: npx @modelcontextprotocol/inspector node build/index.js
3. 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와 관련된 잠재적 위험을 반드시 이해하시기 바랍니다.