Longbridge
公式米国・香港市場 — 110のツール:リアルタイム相場、オプション、注文、ファンダメンタルズ、アラート、DCA、ポートフォリオ
Longbridge MCPで何ができますか?
- リアルタイム相場 —
quoteツールを使用して、米国および香港の銘柄のライブまたは履歴相場、ローソク足、板情報、オプションデータを取得します。 - 取引操作 — マルチレッグのオプション組み合わせを含む注文の発注、取消、変更、およびポジション、残高、約定の確認を行います。
- ファンダメンタル調査 — 企業の財務諸表、配当、EPS予想、バリュエーション、アナリスト評価を取得します。
- ポートフォリオ分析 — Longbridge口座の損益サマリー、実現利益、為替レートを取得します。
- 価格アラート — 価格アラートの作成、一覧表示、有効化、削除を行い、市場の動きを追跡します。
- 積立投資とグリッド取引 — ドルコスト平均法プランとグリッド取引戦略の設定、一時停止、停止を行います。
ホスト型 MCP サーバー
npx add-mcp 'https://mcp.longbridge.com'Claude Code、Codex、Cursor などにインストールできます
ドキュメント
Longbridge MCP Server
Longbridge証券会社向けの公式MCPサーバーです。164のツールを提供し、リアルタイム相場、オプション、注文ルーティング、ファンダメンタルズ、アナリスト評価、カレンダー、IPO、価格アラート、DCAプラン、グリッド取引、ポートフォリオ分析、コミュニティ共有リストをカバーし、米国市場と香港市場に対応しています。rmcpとaxumを使用してRustで構築されています。
ChatGPTとClaudeで利用可能に
LongbridgeはChatGPT AppsディレクトリとClaude Connectorsディレクトリに正式に掲載されています。
プレーンテキストで市場と対話できます — 相場、オプション、ファンダメンタルズ、そして自分のポートフォリオ —
設定ファイルの編集やトークンの貼り付けは不要です。
| 1箇所で追加 | あとは質問するだけ | |
|---|---|---|
| ChatGPT | 設定 → Apps & Connectors → Longbridgeを追加 | 「NVDAの今日の取引状況は?」 · 「香港のポジションを表示して」 |
| Claude | 設定 → Connectors → Longbridgeを追加(Web・デスクトップ・モバイル) | 「AAPLとMSFTのバリュエーションを比較して」 · 「今週のIPOはある?」 |
Longbridgeアカウントで一度サインインするだけです。すべてのリクエストは、以下に記載されている同じホスト型のOAuth 2.1で保護されたエンドポイントを介して実行されます — 読み取り専用の市場データに加え、完全なアカウント、ポートフォリオ、取引ツールがすべて自分の認証情報で保護されています。
ハイライト
- 1つのエンドポイントで164のツール — 相場、オプション、注文ルーティング、ファンダメンタルズ、アナリスト調査、スクリーナー、IPO、アラート、DCA、グリッド取引、ポートフォリオ分析を米国市場と香港市場でカバー。
- ステートレス設計 — すべてのリクエストはBearerトークンをLongbridge SDKに直接転送します。セッションもデータベースもなく、サーバー側に何も保存されません。
- OAuth 2.1、自動検出 — RFC 9728の保護リソースとRFC 8414の認可サーバーメタデータに対応。クライアントはトークンを貼り付けることなくフローを完了できます。
- クリーンで型付けされたレスポンス — snake_caseフィールド、RFC 3339タイムスタンプ、人間が読めるシンボル、MCPリソースとして利用可能な型付けされたレスポンススキーマ。
jqでツールレスポンスをフィルタリング
すべてのツールは、引数にオプションの_jq文字列を受け入れます。この式は、通常のレスポンスシリアライゼーション後に、返された完全なJSONに対して実行されます。_jqという名前は、ビジネスパラメータとの競合を避けるためにレスポンスフィルタリング用に予約されています。使用ガイダンスはMCP initializeレスポンスのinstructionsで一度送信されます。各ツールスキーマはオプションのパラメータ名と型のみを宣言します。例:
{
"name": "quote",
"arguments": {
"symbols": ["AAPL.US", "MSFT.US"],
"_jq": "map({symbol, last_done})"
}
}
.data[:5]を使用してdata配列の最初の5エントリを取得し、.data | map(select(.price > 10))で行を選択し、{total: .total}でフィールドを射影します。式は組み込みのjaqエンジンのjq互換構文を使用します。別途jq実行可能ファイルは不要です。
_jqを省略するか(またはnullを渡す)と、元のレスポンスが保持されます。- 1つの出力値は直接返され、複数の値は配列として返され、値がない場合は
[]として返されます。スカラーと配列は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" } } }
Cursor · Cline · Windsurf · Zed · その他のクライアント — トランスポートstreamable-httpでhttps://mcp.longbridge.comに向けてください。
その他のClaude Codeコマンド
# 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
初回使用時に、クライアントはWWW-Authenticateチャレンジを読み取り、/.well-known/oauth-protected-resource(RFC 9728)を取得し、Longbridge OAuthフローのためにブラウザを開きます。トークンはセッションごとにキャッシュされ、自動的に更新されます。
164のツール
市場データ、取引、調査、アカウント管理をカバーする20のカテゴリ。
| カテゴリ | 数 | 対象範囲 |
|---|---|---|
| 相場 | 32 | リアルタイムおよび履歴相場、ローソク足、板情報、ブローカー、オプション、ワラント、ウォッチリスト、資金フロー、市場温度、空売りポジション、オプション出来高 |
| ファンダメンタル | 33 | 財務諸表/レポート、事業セグメント、機関投資家の見解、業界ピア/バリュエーション、配当、EPS予測、バリュエーションおよびバリュエーション比較、会社情報/経営陣、株主、コーポレートアクション、運営指標 |
| 取引 | 15 | 注文提出/キャンセル/変更、マルチレッグオプション組み合わせ注文、ポジション、残高、約定、キャッシュフロー、信用取引 |
| 市場 | 15 | 市場ステータス、業界/値上がりランキング、ブローカー保有、A/Hプレミアム、取引統計、異常値、空売り取引/信用、指数構成銘柄 |
| DCA | 9 | ドルコスト平均法プランの作成/更新/一時停止/再開/停止、実行履歴、統計、サポートチェック |
| グリッド | 11 | グリッド取引注文の提出/変更/キャンセル/一時停止/再開、リスト/詳細/トリガー履歴の読み取り、シンボルごとの設定情報、一回限りの戦略同意 |
| 共有リスト | 8 | コミュニティ共有リストのCRUD、メンバー追加/削除/並べ替え、人気リスト |
| IPO | 7 | IPO申し込み、カレンダー、上場銘柄、注文詳細、損益分析 |
| コンテンツ | 7 | ニュース一覧/詳細、ディスカッショントピックのCRUDと返信 |
| アラート | 5 | 価格アラートのCRUD(追加、削除、有効化、無効化、一覧) |
| スクリーナー | 5 | 株式スクリーナー検索、指標、戦略レコメンデーション/管理 |
| ポートフォリオ | 4 | 為替レート、損益分析(サマリー、詳細、実現) |
| ATM | 3 | 銀行カード、出金履歴、入金履歴 |
| マクロデータ | 2 | マクロ経済指標の一覧と詳細 |
| 検索 | 2 | ニュース検索、コミュニティトピック検索 |
| 明細 | 2 | アカウント明細の一覧とエクスポート |
| カレンダー | 1 | ファイナンスカレンダー(決算、配当、IPO、マクロデータ、休場) |
| クオンツ | 1 | 履歴Kラインデータに対してクオンツ指標スクリプトを実行 |
| 認証 | 1 | ブラウザリダイレクトを完了できないクライアント向けのOAuthコード交換 |
| ユーティリティ | 1 | 現在のUTC時刻 |
セルフホスティング
独自のインスタンスをお好みですか?公開イメージを実行してください:
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。
設定と環境変数
設定は~/.longbridge/mcp/config.jsonにあります(ディレクトリはLONGBRIDGE_MCP_CONFIG_DIRで上書き可能)。CLIフラグが優先されます。tls_certとtls_keyの両方が設定されている場合、サーバーはHTTPSで実行され、それ以外の場合はHTTPで実行されます。base_urlはTLSありでhttps://localhost:{port}、TLSなしでhttp://localhost:{port}がデフォルトです。
| オプション | 設定キー | CLIフラグ | デフォルト | 説明 |
|---|---|---|---|---|
| バインドアドレス | bind | --bind | 127.0.0.1:8000 | HTTPサーバーのリッスンアドレス |
| ベースURL | base_url | --base-url | 自動 | リソースメタデータの公開ベースURL |
| ログディレクトリ | log_dir | --log-dir | (stderr) | ローテーションログファイルのディレクトリ |
| TLS証明書 | tls_cert | --tls-cert | (なし) | HTTPS用のPEM証明書ファイル |
| TLS秘密鍵 | tls_key | --tls-key | (なし) | HTTPS用のPEM秘密鍵ファイル |
| カナリアアップストリーム | canary | --canary | false | Longbridgeカナリア環境と通信(*.longbridge.xyz)。--canary=falseは設定ファイルで有効になっていても本番環境を強制します |
中国本土環境(*.longbridge.cn)はフラグではありません:LONGBRIDGE_REGION=cnが設定されている場合に自動選択されます(SDKが使用するのと同じ変数)。そのため、本土クラスターには専用の設定は不要です。
アップストリームエンドポイントは選択された環境によって固定されます:
| 本番(デフォルト) | カナリア(--canary) | 本土(LONGBRIDGE_REGION=cn) | |
|---|---|---|---|
| OpenAPI | https://openapi.longbridge.com | https://openapi-global.longbridge.xyz | https://openapi.longbridge.cn |
| 相場WebSocket | wss://openapi-quote.longbridge.com/v2 | wss://openapi-global-quote.longbridge.xyz/v2 | wss://openapi-quote.longbridge.cn/v2 |
| 取引WebSocket | wss://openapi-trade.longbridge.com/v2 | wss://openapi-global-trade.longbridge.xyz/v2 | wss://openapi-trade.longbridge.cn/v2 |
| OAuth / 接続ページ | openapi.longbridge.com / open.longbridge.com | openapi-global.longbridge.xyz / open.longbridge.xyz | openapi.longbridge.cn / open.longbridge.cn |
カナリアはopenapi.longbridge.xyzではなく-globalゲートウェイを使用します:前者のみがCloudFrontの前面にあり、x-dc-regionデータセンタールーティングを実行します。このサーバーは、1つのプロセスからus_およびap_プレフィックスの資格情報を提供するためにこれに依存しています。
カナリアと本土は起動時に上記のすべてのURLを固定します。本番はSDK自身の解決に委ねますが、アップストリームオーバーライドのないus_資格情報はグローバルな.comゲートウェイに固定されます。正確な選択ルールについてはsrc/endpoints.rsを参照してください。
高度な環境変数 — ほとんどのデプロイメントでは触れることはありません。SDKデバッグやエッジ/グローバルエントリデプロイメント用に存在します。
| 変数 | デフォルト | 説明 |
|---|---|---|
LONGBRIDGE_MCP_CONFIG_DIR | ~/.longbridge/mcp | 設定ファイルディレクトリ |
LONGBRIDGE_PUBLIC_HOSTS | (なし) | エッジ注入されたX-Hostヘッダーから受け入れられるカンマ区切りのホスト名。一致するリクエストは401チャレンジ/RFC 9728メタデータでそのホストをエコーします。未設定 = X-Hostは無視されます |
LONGBRIDGE_GLOBAL_OAUTH_URL | (なし) | 許可リストに登録されたX-Host(グローバル単一ドメインエントリ)を介して到着するリクエストにアドバタイズされる認可サーバーURL。未設定 = モードのOpenAPIベースURLにフォールバック |
LONGBRIDGE_MCP_QUOTE_WS_IDLE_TTL_SECS | 600 | キャッシュされた相場WebSocketコンテキストが退避されるまでのアイドル秒数 |
LONGBRIDGE_MCP_QUOTE_WS_MAX_CONTEXTS | 1024 | サーバープロセスあたりの最大キャッシュ相場WebSocketコンテキスト数 |
LONGBRIDGE_MCP_LOG_PAYLOADS | (未設定) | 1はペイロードログ上限を引き上げます(下記参照)。本番では絶対に設定しないでください |
LONGBRIDGE_LOG_PATH | (なし) | SDK内部ログパス。本番では未設定のままにしてください — SDKはフィルタリングされていないリクエスト/レスポンスボディをそこに書き込みます |
ロギングと顧客データ
MCPリクエストとレスポンスは顧客データ(現金残高、ポジション、注文履歴)を運び、上流SDKフレームはアクセストークンを運びます。そのいずれもログファイルに含めるべきではないため、サーバーはそれを出力するログターゲットを制限します。これは`RUST_LOG`とは独立しています:| ターゲット | 上限 | そうでなければ出力される内容 |
|---|---|---|
longbridge_httpcli | warn | OpenAPIリクエストと完全なレスポンスボディ(INFO) |
longbridge_wscli | warn | すべてのWebSocketフレーム(認証トークンを含む)(INFO) |
longbridge::trade | warn | 注文プッシュイベント(INFO) |
rmcp | info | デコードされたMCPリクエストと完全なツール結果(DEBUG)、生のJSON-RPCフレーム(TRACE) |
したがって、冗長性を上げることは安全です:RUST_LOG=debug(またはtrace)を使用すると、顧客データを漏らすことなくサーバー自身のログを取得できます。2つのスイッチがこれを無効にしますが、どちらもデフォルトではオフです — LONGBRIDGE_MCP_LOG_PAYLOADS=1(上限を削除します。ローカルのテストアカウントに対してのみ使用してください)とLONGBRIDGE_LOG_PATH(SDKがフィルタリングされていないボディをそのディレクトリに書き込むようにします。設定時にサーバーは起動時に警告を出します)。
HTTPエンドポイント、認証、およびメトリクス
サーバーはAuthorization: Bearer <token>内のLongbridge OAuthアクセストークンを期待します。認証が欠落しているか無効な場合、401を返し、WWW-Authenticateヘッダーに保護リソースメタデータを指すURLを含めます。これにより、クライアントはLongbridge OAuth認証サーバーに誘導されます。
リクエストにx-papertrading: true(または1)を送信すると、ペーパートレーディング環境に対して実行されます。上流は実資金トークンを使用したペーパートレーディングリクエストを拒否するため、このヘッダーはルーティングスイッチではなく安全ガードです:トークンが実行できることを狭めるだけです。LONGBRIDGE_PAPERTRADING=trueはデプロイメント全体でこれを有効にします。
| メソッド | パス | 説明 |
|---|---|---|
| GET | /.well-known/oauth-protected-resource | 保護リソースメタデータ(RFC 9728) |
| GET | /.well-known/oauth-authorization-server | 認証サーバーメタデータ(RFC 8414)。Longbridgeの直接のauthorize/registerエンドポイントとプロキシされたtoken/revokeエンドポイントを通知します |
| POST | /oauth2/token | OAuthトークンプロキシ。コード/リフレッシュトークンからx-dc-regionを導出し、デフォルトでAPになります |
| POST | /oauth2/revoke | OAuth失効プロキシ。トークンからx-dc-regionを導出し、デフォルトでAPになります |
| GET | /metrics | Prometheusメトリクス |
| POST/GET/DELETE | /mcp | MCP Streamable HTTPエンドポイント(Bearerトークンが必要) |
Prometheusメトリクス:mcp_tool_calls_total(カウンター)、mcp_tool_call_duration_seconds(ヒストグラム)、およびmcp_tool_call_errors_total(カウンター) — それぞれtool_nameでラベル付けされます。
開発
cargo +nightly fmt # format
cargo clippy # lint
cargo test # test
ライセンス
MITライセンスの下で公開されています。