Longbridge
公式米国・香港市場 — 110のツール:リアルタイム相場、オプション、注文、ファンダメンタルズ、アラート、DCA、ポートフォリオ
Longbridge MCPで何ができますか?
- リアルタイム相場 — 米国市場と香港市場のリアルタイムおよび過去の株価、ローソク足、板情報、オプションデータを取得できます。
- ポートフォリオと取引 — 保有ポジション、残高、約定を確認したり、複数レッグのオプション組み合わせを含む注文を発注、取消、訂正したりできます。
- ファンダメンタルズとリサーチ — 株式の財務諸表、配当、アナリストの見解、バリュエーション、会社役員の情報を取得できます。
- スクリーニングとカレンダー — 株式スクリーナーで検索したり、決算、配当、IPO、マクロ経済データの金融カレンダーを確認したりできます。
- アラートと定期プラン — 株価アラートを作成し、ドルコスト平均法のプランを管理し、グリッド取引戦略を設定できます。
- レスポンスの絞り込み — 任意のツールに
_jq式を渡すと、大きなレスポンスから必要なフィールドだけを抽出できます。
ホスト型 MCP サーバー
npx add-mcp 'https://mcp.longbridge.com'Claude Code、Codex、Cursor などにインストールできます
ドキュメント
Longbridge MCP Server
Longbridge証券会社の公式MCPサーバーです。リアルタイム株価、オプション、注文ルーティング、ファンダメンタルズ、アナリスト評価、カレンダー、IPO、価格アラート、DCAプラン、グリッド取引、ポートフォリオ分析、コミュニティのシェアリストにわたる164個のツールを提供し、米国市場と香港市場をカバーします。rmcpとaxumを使用してRustで構築されています。
ChatGPTとClaudeで利用可能になりました
LongbridgeはChatGPT AppsディレクトリとClaude Connectorsディレクトリに正式に掲載されています。
自然な言葉で市場について質問できます。株価、オプション、ファンダメンタルズ、ご自身のポートフォリオなどを、
設定ファイルの編集やトークンの貼り付けなしで利用できます。
| 1か所で追加 | あとは質問するだけ | |
|---|---|---|
| ChatGPT | Settings → Apps & Connectors → Longbridgeを追加 | 「今日のNVDAの取引状況は?」 · 「香港株の保有銘柄を表示して」 |
| Claude | Settings → Connectors → Longbridgeを追加(Web・デスクトップ・モバイル) | 「AAPLとMSFTのバリュエーションを比較して」 · 「今週IPOはある?」 |
Longbridgeアカウントで一度サインインするだけです。すべてのリクエストは、以下に記載する同じホスト型OAuth 2.1保護エンドポイントを経由します。読み取り専用の市場データに加え、アカウント、ポートフォリオ、取引の全ツールを、ご自身の認証情報で保護して利用できます。
主な特長
- 164個のツール、1つのエンドポイント — 米国市場と香港市場を対象に、株価、オプション、注文ルーティング、ファンダメンタルズ、アナリスト調査、スクリーナー、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" } } }
Codex — サーバーを追加し、ブラウザーでOAuthを完了します。
codex mcp add longbridge --url https://mcp.longbridge.com
codex mcp login longbridge
Cursor · Cline · Windsurf · Zed · その他のクライアント — https://mcp.longbridge.comにトランスポートstreamable-httpで接続します。
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のカテゴリです。
| カテゴリ | 数 | 対応範囲 |
|---|---|---|
| Quote | 32 | リアルタイムおよび過去の株価、ローソク足、板情報、ブローカー、オプション、ワラント、ウォッチリスト、資金フロー、市場温度、空売りポジション、オプション出来高 |
| Fundamental | 33 | 財務諸表・レポート、事業セグメント、機関投資家の見解、業界の同業他社・バリュエーション、配当、EPS予測、バリュエーションと比較、企業情報・経営陣、株主、コーポレートアクション、業績指標 |
| Trade | 15 | 注文の発注・キャンセル・変更、複数レッグのオプションコンビネーション注文、ポジション、残高、約定、キャッシュフロー、証拠金 |
| Market | 15 | 市場状況、業界・値上がり上位銘柄ランキング、ブローカー保有状況、A/H株プレミアム、取引統計、異常値、空売り取引・証拠金、指数構成銘柄 |
| DCA | 9 | ドルコスト平均法プランの作成・更新・一時停止・再開・停止、実行履歴、統計、対応状況の確認 |
| Grid | 11 | グリッド取引注文の発注・変更・キャンセル・一時停止・再開、一覧・詳細・トリガー履歴の参照、銘柄ごとの設定情報、戦略への一度限りの同意 |
| Sharelist | 8 | コミュニティのシェアリストのCRUD、メンバーの追加・削除・並べ替え、人気リスト |
| IPO | 7 | IPO申し込み、カレンダー、上場銘柄、注文詳細、損益分析 |
| Content | 7 | ニュース一覧・詳細、ディスカッショントピックのCRUDと返信 |
| Alert | 5 | 価格アラートのCRUD(追加、削除、有効化、無効化、一覧表示) |
| Screener | 5 | 株式スクリーナー検索、指標、戦略の推奨・管理 |
| Portfolio | 4 | 為替レート、損益分析(概要、詳細、実現損益) |
| ATM | 3 | 銀行カード、出金記録、入金記録 |
| Macrodata | 2 | マクロ経済指標の一覧と詳細 |
| Search | 2 | ニュース検索、コミュニティトピック検索 |
| Statement | 2 | 口座明細の一覧表示とエクスポート |
| Calendar | 1 | 金融カレンダー(決算、配当、IPO、マクロデータ、市場休場日) |
| Quant | 1 | 過去のK線データに対する定量指標スクリプトの実行 |
| Authenticate | 1 | ブラウザーリダイレクトを完了できないクライアント向けのOAuthコード交換 |
| Utility | 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を設定します。この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}、未使用時は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 | --canary | false | LongbridgeのCanary環境(*.longbridge.xyz)に接続します。--canary=falseを指定すると、設定ファイルで有効になっていても本番環境が強制されます |
中国本土環境(*.longbridge.cn)はフラグではありません。SDKが使用するものと同じ変数であるLONGBRIDGE_REGION=cnが設定されると自動的に選択されるため、中国本土のクラスターに専用の設定は不要です。
アップストリームエンドポイントは、選択した環境によって固定されます。
| 本番(デフォルト) | Canary(--canary) | 中国本土(LONGBRIDGE_REGION=cn) | |
|---|---|---|---|
| OpenAPI | https://openapi.longbridge.com | https://openapi-global.longbridge.xyz | https://openapi.longbridge.cn |
| Quote WebSocket | wss://openapi-quote.longbridge.com/v2 | wss://openapi-global-quote.longbridge.xyz/v2 | wss://openapi-quote.longbridge.cn/v2 |
| Trade 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 |
Canaryではopenapi.longbridge.xyzではなく-globalゲートウェイを使用します。CloudFront経由で、x-dc-regionデータセンタールーティングを行うのは前者のみです。このサーバーはこれに依存しており、us_およびap_で始まる認証情報を1つのプロセスから処理します。
Canaryと中国本土では、上記のすべての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 | キャッシュされたQuote WebSocketコンテキストが削除されるまでのアイドル秒数 |
LONGBRIDGE_MCP_QUOTE_WS_MAX_CONTEXTS | 1024 | サーバープロセスごとのキャッシュ可能なQuote 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 アクセストークンが指定されていることを想定します。認証情報がない場合、または無効な場合は、保護されたリソースのメタデータを示す WWW-Authenticate ヘッダーを付けて 401 を返します。このメタデータにより、クライアントは 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 の認可/登録エンドポイントへの直接アクセスと、トークン/失効エンドポイントへのプロキシ経由のアクセスを通知します |
| 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 License の下で公開されています。