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

Development Status
- 4 - Beta
Intended Audience
- Developers
License
- OSI Approved :: MIT License
Programming Language

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

longport_mcp-0.3.0.tar.gz (27.8 kB view details)

Uploaded Jan 12, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

longport_mcp-0.3.0-py3-none-any.whl (28.7 kB view details)

Uploaded Jan 12, 2026 Python 3

File details

Details for the file longport_mcp-0.3.0.tar.gz.

File metadata

Download URL: longport_mcp-0.3.0.tar.gz
Upload date: Jan 12, 2026
Size: 27.8 kB
Tags: Source
Uploaded using Trusted Publishing? No
Uploaded via: uv/0.8.17

File hashes

Hashes for longport_mcp-0.3.0.tar.gz
Algorithm	Hash digest
SHA256	`1f6e4f4746ba1f8b58ec628f1a075c6e1b8f47ffd7d54d64aff5363db5ccc847`
MD5	`9f78ea8661b19c95b2f995dc64db59e6`
BLAKE2b-256	`5bb6943affee61c8ae4236eb69420cf7b0ad65c39097208ccc33bab249d555cf`

See more details on using hashes here.

File details

Details for the file longport_mcp-0.3.0-py3-none-any.whl.

File metadata

Download URL: longport_mcp-0.3.0-py3-none-any.whl
Upload date: Jan 12, 2026
Size: 28.7 kB
Tags: Python 3
Uploaded using Trusted Publishing? No
Uploaded via: uv/0.8.17

File hashes

Hashes for longport_mcp-0.3.0-py3-none-any.whl
Algorithm	Hash digest
SHA256	`efa9415e525a458edd2780e151dd4ed7b1f506d2c0c4750aa1e14231065bfc74`
MD5	`13ed889113692ea3f74eb52617390270`
BLAKE2b-256	`7fb9593f51327cece4403f6eb1aeac296f2700ff25eb2e3e3d3d1b25ee33b3aa`