StockMarketScan MCP 서버

Name: stockmarketscan/mcp-server
Author: stockmarketscan

주식 스크리너, 차트 패턴, 옵션 흐름 및 신호 — LLM 클라이언트 내에서 미국 주식 조사를 위한 18가지 도구.

서버 URL: https://mcp.stockmarketscan.com/mcp
전송: HTTP/SSE (Server-Sent Events)
인증: BYOK — 개인 sms_* API 키를 X-API-Key 헤더로 전달
플랜: stockmarketscan.com의 Basic 또는 Pro 플랜이 필요합니다. 옵션 흐름 도구는 옵션 흐름 애드온이 필요합니다.
API 키 발급: stockmarketscan.com/settings
전체 설치 가이드 및 예시: stockmarketscan.com/mcp

제공 도구 — 18가지

카테고리	도구
스크리너 (3)	`list_screeners`, `get_screener_data`, `search_stocks_in_screeners`
차트 패턴 (2)	`get_chart_patterns`, `search_patterns`
옵션 흐름 (4)	`get_options_flow_overview`, `get_options_flow_timeline`, `get_options_flow_signals`, `get_unusual_options_activity`
주식 정보 (2)	`get_stock_info`, `get_candles`
복합 (2)	`get_stock_report`, `search_setups`
시장 상황 (3)	`get_market_momentum`, `get_trends`, `get_trend_connections`
교육 (1)	`explain_concept`

라이브니스 체크를 위한 ping 포함.

설치 — Claude Desktop

claude_desktop_config.json을 편집하세요:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "stockmarketscan": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.stockmarketscan.com/mcp"],
      "headers": {
        "X-API-Key": "sms_your_key_here"
      }
    }
  }
}

Claude Desktop을 재시작하세요. 도구 선택기에서 stockmarketscan을 확인할 수 있습니다.

설치 — Cursor

설정(Settings) → 기능(Features) → 모델 컨텍스트 프로토콜(Model Context Protocol) → 새 MCP 서버 추가(Add New MCP Server):

{
  "name": "stockmarketscan",
  "url": "https://mcp.stockmarketscan.com/mcp",
  "headers": {
    "X-API-Key": "sms_your_key_here"
  }
}

설치 — Continue (VS Code / JetBrains)

~/.continue/config.json을 편집하세요:

{
  "experimental": {
    "modelContextProtocolServers": [
      {
        "transport": {
          "type": "sse",
          "url": "https://mcp.stockmarketscan.com/mcp",
          "headers": {
            "X-API-Key": "sms_your_key_here"
          }
        }
      }
    ]
  }
}

예시 프롬프트

서버가 연결되면 Claude Desktop이나 Cursor에 바로 입력해 보세요:

"오늘 hot-prospects와 golden-cross에 모두 나타나는 주식은 무엇인가요?"
"지난 30일간 AMD의 옵션 흐름 기록을 보여줘."
"컵 앤 핸들(cup and handle) 패턴을 형성 중인 hot-prospects를 찾아줘."
"NVDA에 대한 전체 주식 보고서를 작성해줘 — 스크리너, 패턴, 옵션 흐름, 시장 상황 포함."
"오늘 가장 강력한 강세 옵션 흐름 신호는 무엇인가요?"
"오늘 거래된 계약 중 vol/OI > 3이고 프리미엄이 100만 달러 이상인 것은 무엇인가요?"

인증 작동 방식 (BYOK)

MCP 서버는 자체 API 키를 보유하지 않습니다. 각 클라이언트가 사용자의 개인 sms_* 키를 전달하면, 서버는 세션당 한 번 이를 검증한 후 사용자를 대신하여 api/v1/*에 도구 호출을 프록시합니다. 사용자는 속도 제한 및 할당량을 직접 제어하며, 설정에서 언제든지 키를 교체할 수 있습니다.

속도 제한

플랜	분당	일일	옵션 흐름
Free	—	—	—
Basic	15	500	—
Pro	30	2,000	✓

지원

설치 가이드: stockmarketscan.com/mcp
문의: contact@stockmarketscan.com

소스에서 실행

git clone https://github.com/stockmarketscan/mcp-server.git
cd mcp-server
npm install
STOCKMARKETSCAN_API_KEY=sms_your_key_here npm run dev   # stdio (for Claude Desktop local)
npm run dev:http                                        # HTTP/SSE on :3333

Docker

docker build -t stockmarketscan-mcp .
docker run -p 3333:3333 -e MCP_TRANSPORT=http stockmarketscan-mcp

컨테이너는 $PORT(Railway) 또는 $MCP_PORT(로컬)에서 수신 대기합니다. MCP 클라이언트를 http://localhost:3333/mcp로 지정하고 X-API-Key 헤더를 전달하세요.

stockmarketscan/mcp-server