Longbridge

Longbridge MCP Server

Longbridge 증권사의 공식 MCP 서버입니다. 실시간 시세, 옵션, 주문 라우팅, 펀더멘털, 애널리스트 평가, 캘린더, IPO, 가격 알림, DCA 플랜, 그리드 트레이딩, 포트폴리오 분석 및 커뮤니티 공유 목록을 아우르는 164개 도구를 제공하며, 미국 및 홍콩 시장을 지원합니다. rmcp와 axum을 사용해 Rust로 구축했습니다.

이제 ChatGPT와 Claude에서 사용 가능

Longbridge가 ChatGPT Apps 디렉터리와 Claude Connectors 디렉터리에 공식 등록되었습니다.
자연어로 시장에 대해 질문하세요. 시세, 옵션, 펀더멘털, 나만의 포트폴리오까지 —
설정 파일을 수정하거나 토큰을 붙여넣을 필요가 없습니다.

Longbridge 계정으로 한 번 로그인하세요. 모든 요청은 아래에 설명된 동일한 호스팅 OAuth 2.1 보안 엔드포인트를 통해 실행됩니다. 읽기 전용 시장 데이터와 전체 계정, 포트폴리오 및 거래 도구를 모두 제공하며, 사용자의 자격 증명으로 접근을 제어합니다.

주요 기능

• 164개 도구, 하나의 엔드포인트 — 미국 및 홍콩 시장의 시세, 옵션, 주문 라우팅, 펀더멘털, 애널리스트 리서치, 스크리너, IPO, 알림, DCA, 그리드 트레이딩 및 포트폴리오 분석.
• 상태 비저장 방식으로 설계 — 모든 요청은 Bearer 토큰을 Longbridge SDK로 직접 전달합니다. 세션도 데이터베이스도 없으며, 서버 측에 저장되는 정보도 없습니다.
• OAuth 2.1 자동 검색 — RFC 9728 보호 리소스 및 RFC 8414 인증 서버 메타데이터를 사용합니다. 클라이언트는 붙여넣을 토큰 없이 인증 절차를 완료합니다.
• 명확한 형식의 타입 지정 응답 — snake_case 필드, RFC 3339 타임스탬프, 사람이 읽을 수 있는 심볼, MCP 리소스로 제공되는 타입 지정 응답 스키마.

rmcp와 axum을 사용해 Rust로 구축했습니다.

jq로 도구 응답 필터링

모든 도구는 인수에 선택적 _jq 문자열을 받습니다. 이 표현식은 일반 응답 직렬화가 끝난 뒤 반환된 전체 JSON에 적용됩니다. _jq 이름은 비즈니스 매개변수와의 충돌을 방지하기 위해 응답 필터링 전용으로 예약되어 있습니다. 사용 안내는 MCP initialize 응답의 instructions에 한 번 전송됩니다. 각 도구 스키마에는 선택적 매개변수의 이름과 타입만 선언됩니다. 예를 들면 다음과 같습니다.

{
  "name": "quote",
  "arguments": {
    "symbols": ["AAPL.US", "MSFT.US"],
    "_jq": "map({symbol, last_done})"
  }
}

.data[:5]을 사용해 data 배열의 처음 다섯 항목을 가져오고, .data | map(select(.price > 10))을 사용해 행을 선택하거나, {total: .total}를 사용해 필드를 추출할 수 있습니다. 표현식은 내장된 jaq 엔진의 jq 호환 구문을 사용하므로 별도의 jq 실행 파일이 필요하지 않습니다.

• _jq를 생략하거나 null를 전달하면 원래 응답이 유지됩니다.
• 출력 값이 하나면 그대로 반환되고, 여러 개면 배열로, 값이 없으면 []로 반환됩니다. 스칼라와 배열은 JSON 텍스트이며, 객체는 필터링된 필드만 포함하는 structuredContent에도 표시됩니다.
• 일반 텍스트 응답은 JSON 문자열로 제공됩니다. 구조화된 콘텐츠가 없는 여러 콘텐츠 블록은 배열로 제공됩니다.
• 도구 오류와 권한/데이터 없음 안내는 필터링되지 않습니다.
• 비어 있거나 유효하지 않거나 문자열이 아닌 표현식은 도구 실행 전에 거부됩니다. 런타임에 필터링이 실패하면 도구가 이미 실행되었다는 점을 응답에 명시합니다. 주문 제출과 같은 쓰기 작업을 자동으로 재시도하지 마세요.
• 환경 접근, 파일 시스템 가져오기, 로깅 필터는 사용할 수 없습니다. 출력은 값 10,000개와 8 MiB로 제한됩니다. 한도를 초과하면 일부 결과가 아닌 오류가 반환됩니다.

필터에 따라 응답 형태가 달라질 수 있으므로 도구는 고정된 outputSchema을 알리지 않습니다. 원래 타입 지정 스키마는 스키마를 지원하는 도구의 경우 lb://tools/{tool-name}/output-schema에서 resources/list 및 resources/read을 통해 계속 사용할 수 있습니다.

자체 클라이언트 연결

Longbridge는 **https://mcp.longbridge.com**에서 호스팅 엔드포인트를 운영합니다. MCP 클라이언트에서 해당 엔드포인트를 지정하고 안내에 따라 OAuth를 완료하세요. RFC 9728을 통해 인증이 자동으로 검색되므로 붙여넣을 토큰이 없습니다.

Claude Code

claude mcp add --transport http longbridge https://mcp.longbridge.com

Claude Desktop — claude_desktop_config.json에 추가한 다음 재시작하세요.

{ "mcpServers": { "longbridge": { "url": "https://mcp.longbridge.com" } } }

Codex — 서버를 추가한 다음 브라우저에서 OAuth를 완료하세요.

codex mcp add longbridge --url https://mcp.longbridge.com
codex mcp login longbridge

Cursor · Cline · Windsurf · Zed · 기타 클라이언트 — 전송 방식 streamable-http를 사용해 https://mcp.longbridge.com를 지정하세요.

# Local self-hosted instance (see Self-hosting below)
claude mcp add --transport http longbridge-local http://localhost:8000/mcp

claude mcp list                  # registered servers
claude mcp get longbridge        # config + auth status
claude mcp remove longbridge     # unregister
claude mcp logout longbridge     # re-trigger OAuth after revocation

164개 도구

시장 데이터, 거래, 리서치 및 계정 관리를 아우르는 20개 카테고리입니다.

자체 호스팅

직접 인스턴스를 운영하고 싶으신가요? 게시된 이미지를 실행하세요.

docker run -p 8443:8443 \
  -v /path/to/certs:/certs:ro \
  ghcr.io/longbridge/longbridge-mcp \
  --bind 0.0.0.0:8443 \
  --base-url https://mcp.example.com \
  --tls-cert /certs/cert.pem \
  --tls-key /certs/key.pem

--base-url을 설정하세요. 공개 배포에서는 외부에서 접근 가능한 URL로 설정해야 합니다. 클라이언트가 인증 서버를 검색할 때 사용하는 OAuth 메타데이터에 이 값이 게시됩니다. 기본값은 http://localhost:{port}이며, 원격 클라이언트에서는 사용할 수 없습니다.

또는 소스에서 빌드하세요: cargo build --release && ./target/release/longbridge-mcp.

개발

cargo +nightly fmt      # format
cargo clippy            # lint
cargo test              # test

라이선스

MIT 라이선스에 따라 배포됩니다.