🚀 TWStockMCPServer

대만증권거래소(TWSE) 데이터 분석을 위해 설계된 포괄적인 모델 컨텍스트 프로토콜(MCP) 서버로, 실시간 주식 정보, 재무제표, ESG 데이터 및 추세 분석 기능을 제공합니다.

🌏 언어 버전

• English | 번체 중국어

Related MCP server: Taiwan Stock Agent

🎬 데모 영상

VSCode Copilot 데모

Gemini CLI 데모

TWStockMCPServer 기능 시연 보기

✨ 5대 투자 분석 시나리오

📊 개별 종목 추세 판단

단기, 중기, 장기 기술적 분석, 기본적 분석, 수급 분석 종합

"TSMC(2330)의 최근 추세 분석" / "폭스콘(2317)은 장기 투자에 적합한가요?"

💰 외국인 투자 해석

외국인 지분율, 산업 흐름, 개별 종목 매매 추적

"외국인이 최근 매수하는 종목은?" / "반도체 산업의 외국인 투자 추세는 어떤가요?"

🔥 시장 핫이슈 포착

주요 뉴스, 이상 거래, 워런트 활성도 모니터링

"오늘 주요 뉴스는 무엇인가요?" / "거래량이 비정상적으로 활발한 종목은?"

💎 배당 투자 계획

고배당 수익률 선별, 배당락 일정, 배당 안정성 분석

"고배당 수익률 종목 추천" / "다음 달에 배당락이 예정된 기업은?"

🎯 투자 대상 선별

가치주/성장주 선별, ESG 리스크 평가

"저평가된 가치주를 찾아줘" / "ESG 성과가 좋은 기업은 어디인가요?"

⚙️ 빠른 시작

🚀 온라인 사용 (권장)

{
  "twstockmcpserver": {
    "transport": "streamable_http",
    "url": "https://TW-Stock-MCP-Server.fastmcp.app/mcp"
  }
}

🐳 Docker 사용 (stdio, 서버 직접 구축 불필요)

{
  "twstockmcpserver": {
    "command": "docker",
    "args": [
      "run",
      "-i",
      "--rm",
      "--pull=always",
      "-e",
      "MCP_STDIO=1",
      "ghcr.io/twjackysu/twsemcpserver:latest"
    ]
  }
}

🐳 Docker 사용 (HTTP, 서버 직접 구축)

docker run -d -p 8000:8000 -e PORT=8000 ghcr.io/twjackysu/twsemcpserver:latest

{
  "twstockmcpserver": {
    "transport": "streamable_http",
    "url": "http://localhost:8000/mcp"
  }
}

🔧 로컬 설치

git clone https://github.com/twjackysu/TWStockMCPServer.git
cd TWStockMCPServer
uv sync && uv run fastmcp dev server.py

📡 데이터 출처

🤝 참여 및 기여

PR을 환영합니다!

📄 라이선스 & 면책 조항

MIT 라이선스 | 참고용으로만 제공되며, 투자 권유가 아님