mcpField
L
Longbridge

Longbridge

リモート
longbridge.com金融データ143 日前に更新

Longbridge について

Longbridgeは、Longbridge証券の公式MCPサーバーです。米国・香港市場のデータ、調査、取引、口座関連のツールを提供し、ホスト型OAuth 2.1エンドポイントとセルフホストに対応します。

主な機能

  1. 01相場、オプション、市場データ
  2. 02企業情報とアナリスト調査
  3. 03注文ルーティングと取引プラン
  4. 04ポートフォリオと口座ツール
  5. 05jq互換の式によるレスポンスの絞り込み

活用シーン

  1. 01米国・香港株の相場や評価を確認
  2. 02保有銘柄とポートフォリオの状況を確認
  3. 03取引や積立プランを発注・管理
  4. 04大きなツールレスポンスから必要な項目を抽出

MCP 対応

MCPツールを通じてLongbridgeの相場、取引、調査、口座操作を提供します。クライアントはOAuth 2.1でホスト型エンドポイントに接続するか、セルフホストのインスタンスを利用できます。型付き出力スキーマはMCPリソースとしても参照できます。

設定

リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。

エンドポイントhttps://mcp.longbridge.com
インストールコマンドをコピー
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。

すべてのエンドポイント
Streamable HTTPhttps://mcp.longbridge.com認証が必要
パッケージ
ocighcr.io/longbridge/longbridge-mcp:0.9.0

ツール

詳細

Longbridge

Longbridge MCP サーバー

ChatGPT アプリ Claude コネクター 公式 MCP レジストリ Smithery LobeHub longbridge-mcp MCP サーバー ライセンス Longbridge

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 リソースとして利用できます。

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 配列の最初の 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 フローを開始するためにブラウザーを開きます。トークンはセッションごとにキャッシュされ、自動的に更新されます。

## 164 個のツール

市場データ、取引、調査、口座管理にわたる20のカテゴリーです。

カテゴリー数対応範囲
Quote32リアルタイムおよび過去の相場、ローソク足、板情報、ブローカー、オプション、ワラント、ウォッチリスト、資金フロー、市場温度、空売りポジション、オプション出来高
Fundamental33財務諸表/レポート、事業セグメント、機関投資家の見解、同業他社/評価、配当、EPS予測、評価額と評価比較、企業情報/経営陣、株主、コーポレートアクション、営業指標
Trade15注文の送信/キャンセル/変更、複数レッグのオプションコンビネーション注文、ポジション、残高、約定、キャッシュフロー、証拠金
Market15市場状況、業種/値上がり・値下がり銘柄ランキング、ブローカー保有状況、A株/H株プレミアム、取引統計、異常検知、空売り取引/証拠金、指数構成銘柄
DCA9ドルコスト平均法プランの作成/更新/一時停止/再開/停止、実行履歴、統計、対応状況の確認
Grid11グリッド取引注文の送信/変更/キャンセル/一時停止/再開、一覧/詳細/トリガー履歴の取得、銘柄ごとの設定情報、戦略への一度限りの同意
Sharelist8コミュニティ共有リストのCRUD、メンバーの追加/削除/並べ替え、人気リスト
IPO7IPOの申込、カレンダー、上場銘柄、注文詳細、損益分析
Content7ニュース一覧/詳細、ディスカッショントピックのCRUDと返信
Alert5株価アラートのCRUD(追加、削除、有効化、無効化、一覧表示)
Screener5株式スクリーナー検索、指標、戦略の推奨/管理
Portfolio4為替レート、損益分析(概要、詳細、実現損益)
ATM3銀行カード、出金記録、入金記録
Macrodata2マクロ経済指標の一覧と詳細
Search2ニュース検索、コミュニティトピック検索
Statement2口座明細の一覧表示とエクスポート
Calendar1金融カレンダー(決算、配当、IPO、マクロデータ、休場日)
Quant1過去のK線データに対して定量指標スクリプトを実行
Authenticate1ブラウザーリダイレクトを完了できないクライアント向けのOAuthコード交換
Utility1現在の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--bind127.0.0.1:8000HTTPサーバーのリッスンアドレス
ベースURLbase_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--canaryfalseLongbridgeのCanary環境(*.longbridge.xyz)に接続します。設定ファイルで有効になっていても、--canary=falseを指定すると本番環境が強制されます
中国本土環境(`*.longbridge.cn`)はフラグではありません。`LONGBRIDGE_REGION=cn`(SDK が使用するものと同じ変数)が設定されると自動的に選択されるため、中国本土のクラスターに専用の設定は不要です。

上流エンドポイントは、選択した環境によって固定されます。

本番(デフォルト)Canary(--canary)中国本土(LONGBRIDGE_REGION=cn)
OpenAPIhttps://openapi.longbridge.comhttps://openapi-global.longbridge.xyzhttps://openapi.longbridge.cn
Quote WebSocketwss://openapi-quote.longbridge.com/v2wss://openapi-global-quote.longbridge.xyz/v2wss://openapi-quote.longbridge.cn/v2
Trade WebSocketwss://openapi-trade.longbridge.com/v2wss://openapi-global-trade.longbridge.xyz/v2wss://openapi-trade.longbridge.cn/v2
OAuth / 接続ページopenapi.longbridge.com / open.longbridge.comopenapi-global.longbridge.xyz / open.longbridge.xyzopenapi.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_SECS600キャッシュされた Quote WebSocket コンテキストが削除されるまでのアイドル秒数
LONGBRIDGE_MCP_QUOTE_WS_MAX_CONTEXTS1024サーバープロセスあたりのキャッシュ済み Quote WebSocket コンテキストの最大数
LONGBRIDGE_MCP_LOG_PAYLOADS(未設定)1 を設定すると、ペイロードログの上限が解除されます(下記参照)。本番環境では絶対に設定しないでください
LONGBRIDGE_LOG_PATH(なし)SDK の内部ログパス。本番環境では未設定のままにしてください — SDK はフィルタリングされていないリクエスト/レスポンス本文をそこに書き込みます
ログ記録と顧客データ

MCP のリクエストとレスポンスには顧客データ(現金残高、保有状況、注文履歴)が含まれ、上流 SDK のフレームにはアクセストークンが含まれます。これらをログファイルに記録するべきではないため、サーバーは RUST_LOG に関係なく、該当するログ出力先に上限を設けます。

対象上限上限がない場合に出力される内容
longbridge_httpcliwarnOpenAPI リクエストとレスポンス全文(INFO)
longbridge_wscliwarnすべての WebSocket フレーム(認証トークンを含む)(INFO)
longbridge::tradewarn注文のプッシュイベント(INFO)
rmcpinfoデコード済み 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/tokenOAuth トークンプロキシ。コード/リフレッシュトークンから x-dc-region を導出し、デフォルトは AP です
POST/oauth2/revokeOAuth 失効プロキシ。トークンから x-dc-region を導出し、デフォルトは AP です
GET/metricsPrometheus メトリクス
POST/GET/DELETE/mcpMCP 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 の下で公開されています。

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。