Longbridge について
Longbridgeは、Longbridge証券の公式MCPサーバーです。米国・香港市場のデータ、調査、取引、口座関連のツールを提供し、ホスト型OAuth 2.1エンドポイントとセルフホストに対応します。
主な機能
- 01相場、オプション、市場データ
- 02企業情報とアナリスト調査
- 03注文ルーティングと取引プラン
- 04ポートフォリオと口座ツール
- 05jq互換の式によるレスポンスの絞り込み
活用シーン
- 01米国・香港株の相場や評価を確認
- 02保有銘柄とポートフォリオの状況を確認
- 03取引や積立プランを発注・管理
- 04大きなツールレスポンスから必要な項目を抽出
MCP 対応
MCPツールを通じてLongbridgeの相場、取引、調査、口座操作を提供します。クライアントはOAuth 2.1でホスト型エンドポイントに接続するか、セルフホストのインスタンスを利用できます。型付き出力スキーマはMCPリソースとしても参照できます。
設定
リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。
https://mcp.longbridge.comclaude mcp add --transport http longbridge https://mcp.longbridge.com{"mcpServers":{"longbridge":{"type":"http","url":"https://mcp.longbridge.com"}}}Cursor で開く{"servers":{"longbridge":{"type":"http","url":"https://mcp.longbridge.com"}}}VS Code で開く{"mcpServers":{"longbridge":{"type":"http","url":"https://mcp.longbridge.com"}}}{"mcpServers":{"longbridge":{"serverUrl":"https://mcp.longbridge.com"}}}コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。
https://mcp.longbridge.com認証が必要ghcr.io/longbridge/longbridge-mcp:0.9.0Streamable HTTPツール
詳細
Longbridge MCP サーバー
Longbridge証券の公式 MCP サーバーです。リアルタイム株価、オプション、注文執行、ファンダメンタルズ、アナリスト評価、カレンダー、IPO、価格アラート、DCA プラン、グリッドトレード、ポートフォリオ分析、コミュニティの銘柄リストなど、164 個のツールを備え、米国市場と香港市場をカバーしています。rmcpとaxumを使用して Rust で構築されています。
ChatGPT と Claude で公開中
Longbridge は、ChatGPT アプリディレクトリと Claude コネクターディレクトリに正式に掲載されています。
わかりやすい言葉で市場に質問できます。株価、オプション、ファンダメンタルズ、ご自身のポートフォリオなどに対応します。
設定ファイルの編集やトークンの貼り付けは不要です。
| 1か所で追加 | あとは質問するだけ | |
|---|---|---|
| ChatGPT | 設定 → アプリとコネクター → Longbridge を追加 | 「今日の NVDA の取引状況は?」 · 「香港市場の保有銘柄を表示して」 |
| Claude | 設定 → コネクター → Longbridge を追加(ウェブ・デスクトップ・モバイル) | 「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 を提示しません。元の型付きスキーマは、スキーマ対応ツールの場合、
resources/list および resources/read から lb://tools/{tool-name}/output-schema で利用できます。
独自のクライアントを接続する
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 フローを開始するためにブラウザーを開きます。トークンはセッションごとにキャッシュされ、自動的に更新されます。
市場データ、取引、調査、口座管理にわたる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を指定すると本番環境が強制されます |
上流エンドポイントは、選択した環境によって固定されます。
| 本番(デフォルト) | 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 / openapi.longbridge.cn |
Canary は openapi.longbridge.xyz ではなく、-global ゲートウェイを使用します。CloudFront の背後にあり、x-dc-region によるデータセンタールーティングを行うのは前者だけです。このサーバーは、その機能を利用して、1 つのプロセスで us_ および ap_ 接頭辞付きの認証情報を扱います。
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 ` で 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 の下で公開されています。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。