MCP 서버
Claude Code, Claude Desktop, Cursor의 AI 에이전트가 터미널을 읽고, 거래하고, 레이아웃을 바꾸게 합니다.
spectre-terminal-mcp는 AI 에이전트에게 실행 중인 터미널을 제공하는 Model
Context Protocol 서버입니다. 시장 데이터, 계정, 거래, 레이아웃, 설정을
다룹니다. 사용자의 컴퓨터에서 실행되며 Local API를 통해 터미널과 통신합니다.
설치
pip install spectre-terminal-mcp그다음 터미널에서 Local API를 켜고 토큰을 복사합니다. 토큰 받기를 참고하십시오.
클라이언트에 서버 설정하기
claude mcp add spectre-terminal -e SPECTRE_LOCAL_API_TOKEN=spt_0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef -- spectre-terminal-mcp위의 토큰은 예시이므로 자신의 토큰을 사용합니다. Claude Desktop은 이 블록을
claude_desktop_config.json에 보관합니다. Cursor와 JSON 설정을 쓰는 다른
클라이언트도 같은 블록을 받습니다.
서버는 토큰을 환경 변수에서만 읽고 터미널을 스스로 찾습니다. 터미널이 실행
중이 아니어도 서버는 시작됩니다. 이때 첫 도구 호출은 terminal_unreachable로
응답하고, 다음 호출에서 터미널을 다시 찾습니다.
에이전트가 할 수 있는 일
| 영역 | 에이전트가 할 수 있는 일 | 변경 여부 |
|---|---|---|
| 상태 | 터미널이 실행 중인지 확인하고 연결 목록을 봅니다 | 아니요 |
| 종목 | 코인이나 심볼의 정확한 주소를 찾습니다 | 아니요 |
| 시장 데이터 | 최신 가격, 호가창 상단, 최근 체결 요약, 거래량 클러스터, 캔들을 읽습니다 | 아니요 |
| 계정 | 잔고, 포지션, 미체결 주문, 체결 내역, 레버리지를 읽습니다 | 아니요 |
| 거래 | 주문과 트리거 주문을 넣고 취소하고, 포지션을 청산하고, 레버리지와 마진 모드를 설정합니다 | 예 |
| 워크스페이스 | 레이아웃을 읽습니다. 스택, 탭, 창을 열고, 변경하고, 닫습니다 | 예, 읽기는 제외 |
| 설정 | 설정을 읽고 씁니다 | 예, 읽기는 제외 |
모든 도구와 그 인자는 도구 레퍼런스에 나와 있습니다.
응답은 원시 데이터가 아니라 모델을 위해 만든 짧은 요약입니다. 가격과 수량은 십진수 문자열입니다. 시간은 UTC 밀리초이며, 옆에 ISO 형식 사본이 함께 있습니다.
읽기만 하는 도구는 읽기 전용으로 표시되므로, 클라이언트가 사용자에게 묻지 않고 호출할 수 있습니다. 거래하거나, 레이아웃을 바꾸거나, 설정을 쓰는 도구는 파괴적(destructive)으로 표시되므로, 클라이언트가 호출마다 사용자에게 물을 수 있습니다.
실시간 스트림은 없습니다. 최신 데이터가 필요한 에이전트는 market_snapshot을
다시 호출합니다. 실시간 데이터가 필요한 프로그램은
스트림을 사용합니다.
터미널에 열려 있지 않은 종목은 첫 호출에 최대 3초가 걸립니다. 첫 호출을 참고하십시오.
안전하게 거래하기
실제 자금. 거래 도구는 터미널을 통해 거래소에 실제 주문을 보냅니다. 서버는 자체적으로 확인을 요청하지 않습니다. 호출 전에 사용자에게 묻는지는 MCP 클라이언트에 달려 있습니다.
터미널의 Local API 스위치가 정지 스위치입니다. 끄면 에이전트는 더 이상 읽거나 거래할 수 없습니다.
거래 응답은 accepted이며, 체결되었다는 뜻이 아닙니다. 에이전트는
open_orders와 recent_fills로 결과를 읽습니다.
place_order와 place_trigger에는 client_key가 필요합니다. 같은 키로
호출을 반복하면 새로 넣는 것이 없습니다.
서버는 거래소 키를 절대 보지 못하며, 토큰은 어떤 메시지에도 나타나지 않습니다.
제공되지 않는 것
모스크바 거래소(MOEX)는 지원하지 않습니다. 에이전트는 여러 주문을 한꺼번에 옮기거나, 스택을 탭 사이에서 옮기거나, 열 너비를 바꿀 수 없습니다.
문제 해결
실패한 호출은 도구 오류입니다. 오류 텍스트는 안정적인 코드로 시작합니다.
| 코드 | 이유 | 대처 방법 |
|---|---|---|
terminal_unreachable | 터미널이 실행 중이 아니거나 Local API가 꺼져 있음 | 터미널을 시작하고 Local API를 켭니다 |
local_api_disabled | Local API가 꺼져 있음 | Settings App → 일반 → Local API에서 켭니다 |
token_missing | 서버에 SPECTRE_LOCAL_API_TOKEN이 설정되지 않음 | 서버 설정에 토큰을 추가합니다 |
unauthorized | 토큰이 일치하지 않음 | 현재 토큰을 설정에 복사합니다 |
incompatible_terminal | 터미널이 다른 API 버전을 제공함 | 호환성을 참고하십시오 |
not_active | 종목의 클러스터나 레버리지가 아직 로드되지 않음 | 몇 초 후 다시 요청하거나, 터미널에서 종목을 엽니다 |
rate_limited | API 전용으로 연 종목이 50개를 넘었거나, 초당 새 종목이 5개를 넘음 | 속도를 줄입니다 |
그 밖의 코드는 API의 코드입니다. 오류를 참고하십시오.