longport-mcp

⚠Review·Scanned 2/18/2026

This skill implements a Longport trading MCP server exposing trading, scheduling, and market-data tools. It reads longport_config.json and environment secrets (LONGPORT_APP_KEY, etc.), performs network calls to https://openapi.longportapp.com and https://query2.finance.yahoo.com, and includes a publish.sh that runs rm -rf and uv publish.

from clawhub.ai·v39f051b·107.6 KB·0 installs

Scanned from 0.3.0 at 39f051b · Transparency log ↗

$ vett add clawhub.ai/hakureirm/longport-mcpReview findings below

Longport MCP Server

长桥证券 MCP (Model Context Protocol) 服务器，让 AI Agent 能够进行股票交易、查询行情、管理资产。

特性

REST API + SDK 混合架构: 核心交易功能使用 REST API，高级行情功能使用 SDK
模拟盘/实盘切换: 支持双账户配置，一键切换模拟盘和实盘
41 个 MCP 工具: 覆盖交易、资产、行情、期权/窝轮等全部功能
yfinance 备用: 行情数据支持 yfinance 作为备用源，可查询加密货币
uvx 一键部署: 无需复杂配置

快速开始

安装

# 推荐：uvx 直接运行
uvx longport-mcp

# 或者 pip 安装
pip install longport-mcp

配置

方式 1: 环境变量（支持双账户）

{
  "command": "uvx",
  "args": ["longport-mcp"],
  "env": {
    "LONGPORT_PAPER_APP_KEY": "模拟盘 app_key",
    "LONGPORT_PAPER_APP_SECRET": "模拟盘 app_secret",
    "LONGPORT_PAPER_ACCESS_TOKEN": "模拟盘 access_token",
    "LONGPORT_REAL_APP_KEY": "实盘 app_key",
    "LONGPORT_REAL_APP_SECRET": "实盘 app_secret",
    "LONGPORT_REAL_ACCESS_TOKEN": "实盘 access_token",
    "LONGPORT_DEFAULT_MODE": "paper"
  }
}

方式 2: 配置文件

创建 longport_config.json:

{
    "paper": {
        "app_key": "模拟盘 app_key",
        "app_secret": "模拟盘 app_secret",
        "access_token": "模拟盘 access_token"
    },
    "real": {
        "app_key": "实盘 app_key",
        "app_secret": "实盘 app_secret",
        "access_token": "实盘 access_token"
    },
    "default_mode": "paper"
}

方式 3: 单账户模式（向后兼容）

export LONGPORT_APP_KEY="your_app_key"
export LONGPORT_APP_SECRET="your_app_secret"
export LONGPORT_ACCESS_TOKEN="your_access_token"

模拟盘/实盘切换

# 查看当前模式
get_account_mode()

# 切换到实盘（会显示警告）
switch_account_mode("real")

# 切换回模拟盘
switch_account_mode("paper")

下单时会显示当前模式：[模拟盘] [OK] 订单已提交 或 [实盘] [OK] 订单已提交

可用工具列表

账户管理

工具名	功能
`get_account_mode`	查看当前账户模式（模拟盘/实盘）
`switch_account_mode`	切换账户模式
`check_sdk_status`	检查 SDK 和模块状态

交易工具

工具名	功能
`place_order`	立即下单（市价/限价）
`submit_order_advanced`	高级下单（条件单、盘前盘后）
`modify_order`	修改订单
`cancel_order`	撤销单个订单
`cancel_all_orders`	撤销所有订单
`get_open_orders`	获取今日挂单
`get_today_all_orders`	获取今日所有订单
`get_history_orders`	获取历史订单
`get_order_detail`	获取订单详情
`estimate_buy_limit`	估算最大可买数量

成交记录

工具名	功能
`get_today_executions`	今日成交记录
`get_history_executions`	历史成交记录

资产工具

工具名	功能
`get_assets`	账户资产余额
`get_positions`	股票持仓
`get_fund_positions`	基金持仓
`get_cash_flow`	资金流水
`get_margin_ratio`	保证金比率

行情工具

工具名	功能	数据源
`get_quote`	实时行情（股票/加密货币）	REST API / yfinance
`get_candlesticks`	K线数据	SDK / yfinance
`get_depth`	盘口深度	SDK
`get_brokers`	经纪商队列（港股）	SDK
`get_trades`	成交明细	SDK
`get_intraday`	分时数据	SDK
`get_static_info`	标的基本信息	REST API
`get_symbol_fundamentals`	基本面信息	REST API
`search_symbol`	搜索股票代码	yfinance
`get_exchange_rate`	汇率查询	yfinance

SDK 专属功能

工具名	功能
`get_trading_days`	交易日历
`get_capital_flow`	个股资金流向
`get_capital_distribution`	资金分布

期权/窝轮

工具名	功能
`get_option_expiry_dates`	期权到期日列表
`get_warrant_issuers`	窝轮发行商列表

定时任务

工具名	功能
`schedule_trade`	定时下单
`schedule_cancel_all`	定时全撤
`list_schedules`	查看定时任务
`cancel_schedule`	取消定时任务

通用工具

工具名	功能
`call_longport_api`	通用 API 调用
`get_current_time`	获取当前时间

行情代码格式

美股: AAPL.US, TSLA.US, NVDA.US
港股: 700.HK, 9988.HK
A股: 600519.SH, 000001.SZ
加密货币: BTC-USD, ETH-USD, DOGE-USD (注意用横杠)

获取 API 凭证

注册长桥证券账户
进入开发者后台
创建应用获取 app_key 和 app_secret
生成 access_token（模拟盘和实盘分别生成）

许可证

MIT License