트레이딩 시뮬레이터 MCP 서버

트레이딩 시뮬레이터 API와 상호 작용하는 MCP(모델 컨텍스트 프로토콜) 서버입니다. 이 서버를 통해 클로드와 같은 AI 모델이 MCP 호환 인터페이스를 통해 잔액 확인, 가격 확인 및 거래 실행을 수행할 수 있습니다.

특징

이 MCP 서버는 구조화된 도구 호출을 통해 트레이딩 시뮬레이터 작업에 대한 액세스를 제공합니다.

• 계정 운영
  • 토큰 잔액 받기
  • 포트폴리오 정보를 얻으세요
  • 거래 내역 보기
• 가격 운영
  • 토큰 가격 받기
  • 토큰 정보 가져오기
  • 가격 내역 보기
• 거래 운영
  • 토큰 간 거래 실행
  • 잠재적 거래에 대한 견적을 받으세요
  • 체인 매개변수를 자동으로 처리하는 스마트 토큰 감지
• 경쟁 운영
  • 경쟁 현황 확인
  • 리더보드 순위 보기

스마트 토큰 처리

트레이딩 시뮬레이터 MCP에는 거래 실행을 간소화하는 지능형 토큰 감지 시스템이 포함되어 있습니다.

• 자동 체인 감지 : 일반 토큰으로 거래를 실행할 때 시스템은 자동으로 적절한 블록체인(EVM/SVM)과 특정 체인(ETH, BASE 등) 매개변수를 식별합니다.
• 동일 체인 최적화 : 동일 체인에서 토큰을 거래할 때, 동일 체인 거래에 대한 매개변수가 자동으로 구성됩니다.
• 크로스체인 폴백 : 토큰이 서로 다른 체인에 있어 동일 체인 거래가 실패하면 시스템은 명시적 매개변수나 서버 측 감지로 자연스럽게 폴백합니다.
• 공통 토큰 지원 : 이 시스템에는 주소와 체인 정보가 포함된 공통 토큰 목록이 계속 늘어나고 있습니다.

입증

트레이딩 시뮬레이터 API는 Bearer 토큰 인증을 사용하며, Authorization 헤더에 Bearer 토큰으로 전달된 단일 API 키가 필요합니다.

예:

지엑스피1

설정

1. 저장소를 복제합니다
   git clone https://github.com/yourusername/trading-simulator-mcp.git cd trading-simulator-mcp
2. 종속성 설치
   npm install
3. API 자격 증명을 구성하세요(아래 구성 섹션 참조)
4. 프로젝트를 빌드하세요
   npm run build
5. 서버를 시작합니다
   npm run start

구성

트레이딩 시뮬레이터 MCP 서버를 구성하는 데는 두 가지 옵션이 있습니다.

방법 1: Cursor/Claude에서 직접 구성(권장)

권장되는 방법은 Cursor 또는 Claude Desktop 설정에서 환경 변수를 직접 제공하는 것입니다. 이렇게 하면 보안이 강화되고 .env 파일이 필요하지 않습니다.

• 구성을 통해 이러한 환경 변수가 제공되는 경우 서버는 자동으로 이러한 환경 변수를 사용합니다.
• 구체적인 설정 지침은 아래의 "커서에 추가" 및 "Claude Desktop에 추가" 섹션을 참조하세요.

방법 2: .env 파일 사용(대체)

.env 파일을 사용하거나 명령줄에서 직접 서버를 실행하는 경우:

1. API 자격 증명으로 .env 파일을 만듭니다.
   cp .env.example .env
2. API 키로 .env 파일을 편집하세요
   TRADING_SIM_API_KEY=your_api_key_here TRADING_SIM_API_URL=http://localhost:3000 DEBUG=false
3. 제한된 권한으로 .env 파일을 보호하세요
   chmod 600 .env

환경 변수 우선 순위

트레이딩 시뮬레이터 MCP 서버는 환경 변수에 대해 다음과 같은 우선 순위를 사용합니다.

1. JSON 구성에서 직접 제공되는 환경 변수
2. .env 파일의 환경 변수(존재하고 #1을 사용할 수 없는 경우)
3. 선택적 변수의 기본값(예: API_URL은 기본적으로 " http://localhost:3000 "으로 설정됨)

커서에 추가

이 MCP 서버를 Cursor에 추가하려면:

1. 먼저 npm run build 로 프로젝트를 빌드하세요.
2. 커서에서 설정 > MCP 서버로 이동합니다.
3. "서버 추가"를 클릭하세요
4. 다음 설정으로 서버를 구성하세요.
   • 이름 : Trading Simulator MCP (또는 원하는 이름)
   • 유형 : command
   • 명령어 : node
   • 인수 : /path/to/trading-sim-mcp/dist/index.js (전체 경로 사용)
   • 환경 변수 :
     • TRADING_SIM_API_KEY : API 키
     • TRADING_SIM_API_URL : API 서버 URL(선택 사항)
     • DEBUG : true (선택 사항, 추가 로깅용)
5. "저장"을 클릭하세요

커서 구성에서 환경 변수 사용

보안을 강화하려면 홈 디렉토리의 .cursor/mcp.json 파일을 통해 Cursor를 구성할 수 있습니다.

이 방법을 사용하면 .env 파일이 필요 없게 됩니다.

Claude Desktop에 추가

Claude Desktop에 이 MCP 서버를 추가하려면:

1. 먼저 npm run build 로 프로젝트를 빌드하세요.
2. Claude Desktop 구성 파일은 다음 위치에서 찾을 수 있습니다.
   • macOS의 경우: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows의 경우: %APPDATA%\Claude\claude_desktop_config.json
   • Linux의 경우: ~/.config/Claude/claude_desktop_config.json
3. 다음 내용으로 claude_desktop_config.json 파일을 만들거나 편집하세요.
   { "mcpServers": { "trading-simulator-mcp": { "name": "Trading Simulator MCP", "type": "command", "command": "node", "args": [ "/path/to/trading-simulator-mcp/dist/index.js" ], "env": { "TRADING_SIM_API_KEY": "your_api_key_here", "TRADING_SIM_API_URL": "http://localhost:3000", "DEBUG": "true" } } } }
4. /path/to/trading-simulator-mcp/dist/index.js 컴파일된 서버 파일의 전체 경로로 바꾸세요.
   • 예: /Users/username/trading-simulator-mcp/dist/index.js
5. 구성 파일을 저장하고 Claude Desktop을 다시 시작하세요.

Claude Desktop에 문제가 발생하면 다음 위치에서 로그를 확인하세요.

• macOS의 경우: ~/Library/Logs/Claude/
• Windows의 경우: %USERPROFILE%\AppData\Local\Claude\Logs\
• Linux의 경우: ~/.local/share/Claude/logs/

중요 개발 참고 사항

MCP 서버를 개발할 때는 모든 디버깅 및 로깅에 console.error() 대신 console.log() 사용하세요. Claude Desktop 앱과 Cursor는 stdout을 통해 서버와 통신하므로 console.log() 문은 이 통신을 방해하여 JSON 구문 분석 오류를 발생시킵니다.

MCP 도구

서버는 다음과 같은 MCP 도구를 제공합니다.

계정 도구

• get_balances - 팀의 토큰 잔액을 가져옵니다.
• get_portfolio - 팀의 포트폴리오 정보를 받으세요
• get_trades - 팀의 거래 내역을 가져옵니다

가격 도구

• get_price - 토큰의 현재 가격을 가져옵니다
• get_token_info - 토큰에 대한 자세한 정보를 가져옵니다.
• get_price_history - 토큰의 과거 가격 데이터를 가져옵니다.

거래 도구

• execute_trade - 두 토큰 간 거래 실행
  • 공통 토큰에 대한 체인 매개변수를 자동으로 감지하고 할당합니다.
  • 명시적인 체인 매개변수를 요구하지 않고 동일 체인 거래를 지원합니다.
  • 크로스체인 시나리오에 대해 우아하게 다시 폴백합니다.
• get_quote - 잠재적 거래에 대한 견적 받기

경쟁 도구

• get_competition_status - 현재 경쟁의 상태를 가져옵니다
• get_leaderboard - 경쟁 순위표 가져오기

일반 토큰

이 시스템에는 토큰 주소를 해당 체인에 매핑하는 COMMON_TOKENS 구조가 포함되어 있습니다. 이를 통해 거래 실행 시 체인 매개변수를 자동으로 감지할 수 있습니다.

현재 공통 토큰은 다음과 같습니다.

솔라나(SVM)

• USDC: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
• 솔: So11111111111111111111111111111111111111112

이더리움(EVM)

• USDC: 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48
• WETH: 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2

베이스(EVM)

• USDC: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
• 이더리움: 0x4200000000000000000000000000000000000006

더 일반적인 토큰을 추가하려면 types.ts 파일에서 COMMON_TOKENS 객체를 확장하면 됩니다.

보안 고려 사항

• API 키는 안전하게 보관해야 하며 클라이언트 측 코드에서 공유되거나 노출되어서는 안 됩니다.
• 프로덕션 환경에서 API에 연결할 때는 항상 HTTPS를 사용하세요.
• API 키는 거래를 실행하기 위한 전체 액세스 권한을 가지고 있으므로 이에 따라 보호해야 합니다.