moomoo Market Data MCP

공식 Futu OpenAPI(futu-api)의 실시간 시장 데이터를 Codex 및 기타 MCP 클라이언트에 제공하는 읽기 전용 Model Context Protocol 서버입니다.

이 프로젝트는 시장 데이터 도구만 제공합니다. 주문, 계정, 포지션 또는 자금 이체 기능은 포함되어 있지 않습니다.

도구

• moomoo_connection_status — Futu OpenD 연결 확인

• moomoo_snapshot — 하나 이상의 심볼에 대한 시장 스냅샷

• moomoo_quote — 구독한 실시간 호가

• moomoo_candles — 현재 K-라인/캔들스틱 데이터

• moomoo_order_book — 실시간 호가창(오더북)

• moomoo_ticker — 최근 체결 내역

• moomoo_search_securities — 코드 또는 이름으로 증권 검색

심볼은 Futu 형식을 사용합니다. 예: US.AAPL, HK.00700, SH.600519.

요구 사항

• Python 3.10+

• Futu OpenD 설치, 로그인, 실행 상태

• moomoo/Futu 계정에 필요한 실시간 호가 권한

기본 OpenD 엔드포인트는 127.0.0.1:11111입니다. 이 서버는 moomoo 비밀번호가 필요하지 않습니다.

설치 및 실행

git clone https://github.com/amao69904/moomoo-market-data-mcp.git
cd moomoo-market-data-mcp
python -m venv .venv
source .venv/bin/activate
pip install -e .
moomoo-market-data-mcp

선택적 환경 변수:

export FUTU_OPEND_HOST=127.0.0.1
export FUTU_OPEND_PORT=11111

Codex MCP 구성

설치된 Python 환경을 사용하여 서버를 추가합니다:

[mcp_servers.moomoo-market-data]
command = "/absolute/path/to/moomoo-market-data-mcp/.venv/bin/moomoo-market-data-mcp"

[mcp_servers.moomoo-market-data.env]
FUTU_OPEND_HOST = "127.0.0.1"
FUTU_OPEND_PORT = "11111"

MCP 구성을 변경한 후 Codex를 다시 시작하고 moomoo_connection_status를 호출하세요.

데이터 및 안전 참고 사항

• 가용성, 지연 시간, 깊이 및 범위는 OpenD, 계정 지역, 거래소 운영 시간 및 호가 권한에 따라 달라집니다.

• 구독 할당량은 Futu가 적용합니다.

• 반환된 데이터는 정보 제공용이며 투자 조언이 아닙니다.

• OpenD를 공개 인터넷에 노출하지 마세요. localhost 또는 신뢰할 수 있는 사설 네트워크에 유지하세요.

개발

pip install -e ".[dev]"
pytest

라이선스

MIT