LongPort MCP

A MCP server implementation for LongPort OpenAPI, provides real-time stock market data, provides AI access analysis and trading capabilities through MCP.

Features

Trading - Create, amend, cancel orders, query today’s/past orders and transaction details, etc.
Quotes - Real-time quotes, acquisition of historical quotes, etc.
Portfolio - Real-time query of the account assets, positions, funds

Installation

macOS or Linux

Run script to install:

curl -sSL https://raw.githubusercontent.com/longportapp/openapi/refs/heads/main/mcp/install | bash

Windows

Download the latest binary from the Releases page.

Example Prompts

Once you done server setup, and connected, you can talk with AI:

What's the current price of AAPL and TSLA stock?
How has Tesla performed over the past month?
Show me the current values of major market indices.
What's the stock price history for TSLA, AAPL over the last year?
Compare the performance of TSLA, AAPL and NVDA over the past 3 months.
Generate a portfolio performance chart for my holding stocks, and return me with data table and pie chart (Just return result no code).
Check the price of the stocks I hold today, and if they fall/rise by more than 3%, sell(If fall, buy if rise) 1/3 at the market price.

Usage

Use in Cursor

To configure LongPort MCP in Cursor:

Open Cursor Settings
Go to Features > MCP Servers
Click + Add New MCP Server
Enter the following:
- Name: longport-mcp (or your preferred name)
- Type: command
- Command: env LONGPORT_APP_KEY=your-app-key LONGPORT_APP_SECRET=your-app-secret LONGPORT_ACCESS_TOKEN=your-access-token longport-mcp

If you are using Windows, replace command with cmd /c "set LONGPORT_APP_KEY=your-app-key && set LONGPORT_APP_SECRET=your-app-secret && set LONGPORT_ACCESS_TOKEN=your-access-token && longport-mcp"

Or use this config:

{
  "mcpServers": {
    "longport-mcp": {
      "command": "/usr/local/bin/longport-mcp",
      "env": {
        "LONGPORT_APP_KEY": "your-app-key",
        "LONGPORT_APP_SECRET": "your-app-secret",
        "LONGPORT_ACCESS_TOKEN": "your-access-token"
      }
    }
  }
}

Use in Cherry Studio

To configure LongPort MCP in Cherry Studio:

Go to Settings > MCP Servers
Click + Add Server
Enter the following:
- Name: longport-mcp (or your preferred name)
- Type: STDIO
- Command: env LONGPORT_APP_KEY=your-app-key LONGPORT_APP_SECRET=your-app-secret LONGPORT_ACCESS_TOKEN=your-access-token longport-mcp

If you are using Windows, replace command with cmd /c "set LONGPORT_APP_KEY=your-app-key && set LONGPORT_APP_SECRET=your-app-secret && set LONGPORT_ACCESS_TOKEN=your-access-token && longport-mcp"

Running as a SSE server

env LONGPORT_APP_KEY=your-app-key LONGPORT_APP_SECRET=your-app-secret LONGPORT_ACCESS_TOKEN=your-access-token longport-mcp --sse

Default bind address is 127.0.0.1:8000, you can change it by using the --bind flag:

longport-mcp --sse --bind 127.0.0.1:3000

Configuration

Readonly mode

To run the server in read-only mode, set the flag --readonly:

longport-mcp --readonly

This will prevent the server from submitting orders to the exchange.

Enable logging

To enable logging, set the flag --log-dir to the directory where you want to store the logs:

longport-mcp --log-dir /path/to/log/dir

长桥