AI导哈

证券交易服务器

长桥证券MCP服务器是一个支持AI代理进行股票交易、查询行情和管理资产的金融工具。

  • by Hakureirm
  • Python
  • 本地部署
  • 8 星标
  • 更新于
在 GitHub 查看 Hakureirm/longport_mcp

使用说明

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 凭证

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

许可证

MIT License

相关 MCP