longbridge

Официальный MCP-сервер для брокера Longbridge. 110 инструментов, включая котировки в реальном времени, опционы, маршрутизацию ордеров, фундаментальные показатели, рейтинги аналитиков, календари, ценовые оповещения, планы DCA, аналитику портфеля и списки акций сообщества — охватывает рынки США и Гонконга. Написан на Rust с использованием rmcp и axum.

Функции

• 110 инструментов MCP в 11 категориях: котировки, торговля, фундаментальные показатели, рыночные данные, календари, портфель, оповещения, контент, выписки по счету, DCA и списки акций сообщества

• Архитектура без сохранения состояния (stateless) — каждый запрос содержит токен Bearer, передаваемый напрямую в SDK Longbridge; никаких сессий на стороне сервера или баз данных

• Метаданные ресурсов OAuth 2.1, соответствующие RFC 9728, направляющие клиентов к OAuth Longbridge для авторизации

• Преобразование JSON-ответов — имена полей нормализованы в snake_case, временные метки преобразованы в RFC 3339, внутренние значения counter_id сопоставлены с понятными человеку символами

• Метрики Prometheus для мониторинга вызовов инструментов, задержек и ошибок

• Настраиваемость через аргументы CLI или JSON-файл конфигурации (CLI имеет приоритет)

Related MCP server: Stock MCP Server

Подключение из MCP-клиента

Longbridge поддерживает хостинг-эндпоинт по адресу https://openapi.longbridge.com/mcp, поэтому большинству пользователей не нужно запускать собственный сервер — просто укажите его в своем MCP-клиенте и пройдите OAuth при появлении запроса. Авторизация обнаруживается автоматически через RFC 9728.

Claude Desktop

Добавьте в ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) или аналогичный файл в вашей ОС:

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

Перезапустите Claude Desktop. При первом вызове инструмента откроется браузер для завершения процесса OAuth Longbridge.

Claude Code

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

Cursor / Cline / Windsurf / другие MCP-клиенты

Укажите клиенту адрес https://openapi.longbridge.com/mcp, используя транспорт streamable-http. OAuth обнаруживается автоматически через RFC 9728; ручной ввод токена не требуется.

Самостоятельный хостинг

Предпочитаете запускать собственный экземпляр? Используйте Docker или соберите из исходного кода.

Docker (рекомендуется)

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 вашего сервера (например, https://mcp.example.com). Этот URL возвращается в метаданных защищенного ресурса OAuth и используется MCP-клиентами для обнаружения сервера авторизации. Если он не задан, по умолчанию используется http://localhost:{port}, что не будет работать для удаленных клиентов.

Сборка из исходного кода

cargo build --release
./target/release/longbridge-mcp

Настройка

Создайте файл конфигурации в ~/.longbridge/mcp/config.json (необязательно):

{
  "bind": "127.0.0.1:8000",
  "base_url": "https://mcp.example.com",
  "log_dir": "/var/log/longbridge-mcp"
}

Конфигурация

Аргументы CLI переопределяют значения из файла конфигурации. Файл конфигурации считывается из ~/.longbridge/mcp/config.json (можно переопределить через LONGBRIDGE_MCP_CONFIG_DIR).

Когда заданы и tls_cert, и tls_key, сервер запускается по HTTPS. В противном случае он переключается на HTTP. base_url по умолчанию принимает значение https://localhost:{port} при использовании TLS или http://localhost:{port} без него.

Переменные окружения

Это расширенные настройки — большинству пользователей не нужно их менять. Они в основном полезны для подключения к непроизводственным средам Longbridge или отладки внутренних компонентов SDK.

Аутентификация

Сервер ожидает токен доступа Longbridge OAuth в заголовке Authorization: Bearer <token>. При отсутствии или неверных данных аутентификации он возвращает 401 с заголовком WWW-Authenticate, указывающим на эндпоинт метаданных защищенного ресурса, который, в свою очередь, направляет MCP-клиенты на сервер авторизации OAuth Longbridge.

Интеграция с Claude Code

Одна команда в разделе Подключение → Claude Code обеспечит вам подключение. Ниже приведены дополнительные команды, которые могут понадобиться при разработке с использованием этого сервера.

# Hosted — use this unless you have a reason not to
claude mcp add --transport http longbridge https://openapi.longbridge.com/mcp

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

# Inspect
claude mcp list                         # registered servers
claude mcp get longbridge               # config + auth status of one server
claude mcp remove longbridge            # unregister

# Re-trigger OAuth (e.g. after token revocation on the Longbridge side)
claude mcp logout longbridge

При первом вызове инструмента Claude Code считывает запрос WWW-Authenticate с сервера, получает /.well-known/oauth-protected-resource (RFC 9728) и открывает ваш браузер для процесса OAuth Longbridge. Токены доступа кэшируются для каждой сессии и обновляются автоматически.

API-эндпоинты

Категории инструментов

Метрики Prometheus

Структура проекта

src/
  main.rs              CLI args, config loading, axum server setup
  auth/
    mod.rs             Router composition, MCP service wiring
    metadata.rs        Protected Resource Metadata (RFC 9728)
    middleware.rs       Bearer token extraction middleware
  tools/
    mod.rs             MCP tool definitions and ServerHandler impl
    quote.rs           Quote tools (SDK QuoteContext)
    trade.rs           Trade tools (SDK TradeContext)
    fundamental.rs     Fundamental data (HTTP API)
    market.rs          Market data extensions (HTTP API)
    calendar.rs        Finance calendar (HTTP API)
    portfolio.rs       Portfolio analytics (HTTP API)
    dca.rs             Dollar-cost averaging / recurring investment (HTTP API)
    sharelist.rs       Community sharelist management (HTTP API)
    alert.rs           Price alerts (HTTP API)
    content.rs         News, topics, filings (SDK ContentContext + HTTP)
    statement.rs       Account statements (HTTP API)
    http_client.rs     Shared HTTP client helpers
    parse.rs           Parameter parsing helpers
  serialize/           JSON transformation (snake_case, timestamps, counter_id -> symbol)
  counter.rs           Symbol <-> counter_id bidirectional conversion
  metrics.rs           Prometheus metric definitions and /metrics handler
  error.rs             Unified error type (thiserror)

Разработка

# Format
cargo +nightly fmt

# Lint
cargo clippy

# Test
cargo test

Лицензия

Подробности см. в LICENSE.