FxSocket

npx add-mcp 'https://mcp.fxsocket.com/mcp'

MetaTrader MCP 서버

AI 에이전트에게 MetaTrader 4 및 MetaTrader 5 계정에 대한 읽기 권한을 부여하세요. FxSocket MCP 서버를 사용하면 Claude, Cursor, VS Code 및 기타 모든 Model Context Protocol 클라이언트가 귀하의 거래에 관한 질문에 답할 수 있습니다. 계정 전반의 잔액과 자산, 현재 열려 있는 포지션, 지난달의 실적, 실시간 시세 및 가격 이력 등이 포함됩니다. 읽기 전용입니다. 어떤 도구도 주문을 넣거나, 수정하거나, 청산할 수 없습니다.

서버 URL https://mcp.fxsocket.com/mcp

1. 읽기 전용 API 키 생성

API Key 페이지에서 읽기 전용 키를 생성하세요. 이 키는 fxs_ro_로 시작하며, 여기의 모든 도구를 호출할 수 있고, 다른 어떤 엔드포인트를 통해서도 거래할 수 없습니다. 이름을 지정하고 에이전트가 볼 수 있어야 하는 계정으로 제한하면, 에이전트는 다른 계정의 존재조차 알 수 없습니다. 전체 fxs_live_ 키도 사용할 수 있지만, 에이전트에게는 그런 키가 필요하지 않습니다.

2. 클라이언트 연결

원격 서버 URL과 헤더를 받는 클라이언트는 직접 연결합니다. Claude Desktop처럼 로컬 서버만 시작하는 클라이언트는 Docker 이미지를 사용합니다.

claude mcp add --transport http fxsocket https://mcp.fxsocket.com/mcp \
  --header "X-API-Key: fxs_ro_xxx"

{
  "mcpServers": {
    "fxsocket": {
      "url": "https://mcp.fxsocket.com/mcp",
      "headers": { "X-API-Key": "fxs_ro_xxx" }
    }
  }
}

{
  "servers": {
    "fxsocket": {
      "type": "http",
      "url": "https://mcp.fxsocket.com/mcp",
      "headers": { "X-API-Key": "fxs_ro_xxx" }
    }
  }
}

{
  "mcpServers": {
    "fxsocket": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "FXSOCKET_API_KEY", "fxsocket/mcp"],
      "env": { "FXSOCKET_API_KEY": "fxs_ro_xxx" }
    }
  }
}

다른 클라이언트도 같은 방식으로 작동합니다. https://mcp.fxsocket.com/mcp을 가리키도록 하고 키를 X-API-Key 헤더에 넣거나(Authorization: Bearer도 허용됨), Docker 이미지를 로컬 서버로 실행하세요.

도구

여덟 개의 도구로, 모두 읽기 전용입니다. 각 도구는 엔드포인트가 아니라 질문을 중심으로 설계되어 있어, "내 계정 전체에서 무엇이 열려 있나"는 모든 터미널을 한 번에 읽는 한 번의 호출입니다.

• list_accounts: 키가 볼 수 있는 모든 계정과 그 id, 닉네임, 플랫폼, 서버, 로그인 및 연결 상태를 보여주며, 선택적으로 잔액, 자산 및 통화별 합계를 포함합니다. 에이전트가 가장 먼저 호출합니다.
• get_account: 한 계정의 전체 정보: 잔액, 자산, 마진, 마진 레벨 및 레버리지, 스톱아웃 레벨 같은 계정 설정, 그리고 터미널 상태.
• get_open_positions: 계정 전반의 열린 포지션과 대기 주문으로, 심볼과 유형별로 필터링할 수 있으며, 변동 손익, 스왑 및 통화별 합계를 포함합니다.
• get_trade_history: 특정 기간(기본값은 최근 7일, 최대 366일)의 청산된 거래로, 승리, 손실, 승률, 순이익, 최고 및 최악의 거래, 심볼별 분석을 포함합니다.
• search_symbols: 브로커의 정확한 심볼 이름. 일부 브로커에서는 EURUSD가 EURUSD.sd 또는 EURUSDm이므로, 에이전트는 가격을 요청하기 전에 이를 조회합니다.
• get_quotes: 최대 20개 심볼의 실시간 매수 호가, 매도 호가 및 스프레드.
• get_symbol_info: 계약 사양: 소수 자릿수, 계약 크기, 틱 가치, 거래량 한도, 스왑 금리, 수수료 및 거래 세션.
• get_price_history: 심볼과 타임프레임에 대한 OHLC 캔들로, 호출당 최대 500개 바.

무엇을 물어볼 수 있나

• "모든 계정의 총 자산은 통화별로 얼마인가?"
• "지금 적자 상태인 열린 포지션은 무엇이고, 얼마나 손실인가?"
• "지난달 XAUUSD의 승률은 얼마였고, 최악의 거래는 무엇이었나?"
• "내 각 브로커의 EURUSD 스프레드를 비교해 줘."
• "GBPUSD의 최근 H1 캔들 200개를 가져와서 추세를 설명해 줘."

설계상 읽기 전용

이 서버가 거래할 수 없는 이유는 설정이 아니라 코드가 접근할 수 있는 범위 때문입니다. 모든 도구는 터미널에서 읽기만 하며, 어떤 도구도 주문을 보낼 수 없습니다. 따라서 혼란스럽거나 조작된 에이전트라도 포지션을 열거나, 변경하거나, 청산할 수 없습니다.

금액은 각 계정의 예치 통화로 보고되며 통화 간에 합산되지 않습니다. 도구는 통화별 합계를 반환하므로 모델이 그 산술을 직접 할 필요가 없습니다. 시간은 API의 다른 곳과 마찬가지로 브로커 서버 시간입니다.

제한: 사용자당 분당 60회 요청, 응답 하나에 최대 50개 계정 및 300개 주문 또는 거래 행. 개수와 합계는 항상 전체를 포함하며, 행 목록만 잘립니다.

Docker로 로컬에서 실행

fxsocket/mcp 이미지는 서버를 로컬 stdio 프로세스로 실행하며, 서버를 직접 시작하는 클라이언트를 위한 것입니다. 의존성이 없는 하나의 Python 파일로 된 작은 릴레이로, 각 메시지를 귀하의 키와 함께 mcp.fxsocket.com로 전달합니다. 도구와 데이터는 여전히 FxSocket에서 오므로, 도구가 변경되어도 이미지를 업데이트할 필요가 없습니다. amd64 및 arm64용으로 게시되었습니다.

FXSOCKET_API_KEY=fxs_ro_xxx docker run -i --rm -e FXSOCKET_API_KEY fxsocket/mcp

Docker Hub · GitHub의 소스 (MIT)

프로토콜 세부 사항

• 전송: Streamable HTTP, POST 전용, JSON 응답. 상태 비저장이며 유지할 세션이 없습니다.
• 프로토콜 버전: 2026-07-28(요청별 메타데이터, 핸드셰이크 없음) 및 2025-03-26부터 2025-11-25까지(initialize 핸드셰이크).
• 인증: 플랫폼 API와 동일한 API 키를 X-API-Key 또는 Authorization: Bearer에 사용합니다.
• 아직 지원되지 않음: claude.ai 및 ChatGPT의 웹 커넥터는 헤더 대신 OAuth로 로그인합니다. Claude Desktop은 현재 Docker 이미지를 통해 작동합니다.