LongPort MCP

1# LongPort MCP
2 
3A [MCP](https://modelcontextprotocol.io/introduction) server implementation for [LongPort OpenAPI](https://open.longportapp.com), provides real-time stock market data, provides AI access analysis and trading capabilities through MCP.
4 
5## Documentation
6 
7- LongPort OpenAPI: https://open.longportapp.com/en/
8- SDK docs: https://longportapp.github.io/openapi
9 
10## Features
11 
12- Trading - Create, amend, cancel orders, query today’s/past orders and transaction details, etc.
13- Quotes - Real-time quotes, acquisition of historical quotes, etc.
14- Portfolio - Real-time query of the account assets, positions, funds
15 
16## Installation
17 
18### macOS or Linux
19 
20Run script to install:
21 
22```bash
23curl -sSL https://raw.githubusercontent.com/longportapp/openapi/refs/heads/main/mcp/install | bash
24```
25 
26### Windows
27 
28Download the latest binary from the [Releases](https://github.com/longportapp/openapi/releases/tag/longport-mcp-0.1.0) page.
29 
30## Example Prompts
31 
32Once you done server setup, and connected, you can talk with AI:
33 
34- What's the current price of AAPL and TSLA stock?
35- How has Tesla performed over the past month?
36- Show me the current values of major market indices.
37- What's the stock price history for TSLA, AAPL over the last year?
38- Compare the performance of TSLA, AAPL and NVDA over the past 3 months.
39- Generate a portfolio performance chart for my holding stocks, and return me with data table and pie chart (Just return result no code).
40- 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.
41 
42## Usage
43 
44### Use in Cursor
45 
46To configure LongPort MCP in Cursor:
47 
48- Open Cursor Settings
49- Go to Features > MCP Servers
50- Click `+ Add New MCP Server`
51- Enter the following:
52  - Name: `longport-mcp` (or your preferred name)
53  - Type: `command`
54  - Command: `env LONGPORT_APP_KEY=your-app-key LONGPORT_APP_SECRET=your-app-secret LONGPORT_ACCESS_TOKEN=your-access-token longport-mcp`
55 
56If 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"`
57 
58Or use this config:
59 
60```json
61{
62  "mcpServers": {
63    "longport-mcp": {
64      "command": "/usr/local/bin/longport-mcp",
65      "env": {
66        "LONGPORT_APP_KEY": "your-app-key",
67        "LONGPORT_APP_SECRET": "your-app-secret",
68        "LONGPORT_ACCESS_TOKEN": "your-access-token"
69      }
70    }
71  }
72}
73```
74 
75### Use in Cherry Studio
76 
77To configure LongPort MCP in Cherry Studio:
78 
79- Go to Settings > MCP Servers
80- Click `+ Add Server`
81- Enter the following:
82  - Name: `longport-mcp` (or your preferred name)
83  - Type: `STDIO`
84  - Command: `env LONGPORT_APP_KEY=your-app-key LONGPORT_APP_SECRET=your-app-secret LONGPORT_ACCESS_TOKEN=your-access-token longport-mcp`
85 
86If 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"`
87 
88## Running as a SSE server
89 
90```bash
91env LONGPORT_APP_KEY=your-app-key LONGPORT_APP_SECRET=your-app-secret LONGPORT_ACCESS_TOKEN=your-access-token longport-mcp --sse
92```
93 
94Default bind address is `127.0.0.1:8000`, you can change it by using the `--bind` flag:
95 
96```bash
97longport-mcp --sse --bind 127.0.0.1:3000
98```
99 
100## Configuration
101 
102### Readonly mode
103 
104To run the server in read-only mode, set the flag `--readonly`:
105 
106```bash
107longport-mcp --readonly
108```
109 
110This will prevent the server from submitting orders to the exchange.
111 
112### Enable logging
113 
114To enable logging, set the flag `--log-dir` to the directory where you want to store the logs:
115 
116```bash
117longport-mcp --log-dir /path/to/log/dir
118```
119