chnyangjie-snbpy-mcp 0.1.0

MCP server for Snowball Securities (雪盈证券) trading API

chnyangjie-snbpy-mcp

MCP server for Snowball Securities (雪盈证券) trading API. Lets AI agents place orders, check balances, and manage positions.

Quick Start

# 1. Install the package
pip install chnyangjie-snbpy-mcp

# 2. Set environment variables
export SNB_ACCOUNT=your_account
export SNB_KEY=your_key

# 3. Auto-install into Claude Desktop
snbpy-install

# 4. Restart Claude Desktop

Setup

cd snbpy-mcp
pip install -e .

Environment Variables

Variable	Required	Default	Description
SNB_ACCOUNT	Yes	-	Account ID
SNB_KEY	Yes	-	API secret key
SNB_SERVER	No	sandbox.snbsecurities.com	API server
SNB_PORT	No	443	Port
SNB_SCHEMA	No	https	HTTP schema
SNB_TIMEOUT	No	10000	Timeout (ms)

Run

# Development (MCP Inspector)
SNB_ACCOUNT=xxx SNB_KEY=yyy mcp dev server.py

# Direct stdio
SNB_ACCOUNT=xxx SNB_KEY=yyy python server.py

Tools

Tool	Description
login	Verify API credentials
place_order	Place a trade order
cancel_order	Cancel an order
get_order_by_id	Query single order
get_order_list	Query orders (paginated)
get_transaction_list	Query fills (paginated)
get_balance	Query account balance
get_position_list	Query positions

Use with Claude Desktop

Option 1: Auto-install (Recommended)

export SNB_ACCOUNT=your_account
export SNB_KEY=your_key
snbpy-install

Option 2: Use uvx (zero install)

uvx chnyangjie-snbpy-mcp

Option 3: Manual config

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "chnyangjie-snbpy": {
      "command": "python",
      "args": ["/path/to/server.py"],
      "env": {
        "SNB_ACCOUNT": "YOUR_ACCOUNT",
        "SNB_KEY": "YOUR_KEY"
      }
    }
  }
}