chnyangjie-snbpy-mcp 0.1.2

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.

Features

• Place, cancel, and query trade orders
• Check account balance and positions
• Query transaction history
• Support for US/HK/CN stocks, options, futures, and more

Quick Start

Option 1: uvx (Recommended - Zero Install)

No installation needed. Just configure Claude Desktop:

{
  "mcpServers": {
    "chnyangjie-snbpy": {
      "command": "uvx",
      "args": ["chnyangjie-snbpy-mcp"],
      "env": {
        "SNB_ACCOUNT": "YOUR_ACCOUNT",
        "SNB_KEY": "YOUR_KEY"
      }
    }
  }
}

Option 2: pip install

pip install chnyangjie-snbpy-mcp

# Auto-configure Claude Desktop
export SNB_ACCOUNT=your_account
export SNB_KEY=your_key
snbpy-install

# Restart Claude Desktop

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)

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

Development

# Clone the repo
git clone https://github.com/chnyangjie/snbpy-mcp.git
cd snbpy-mcp

# Install in editable mode
pip install -e .

# Run with MCP Inspector
SNB_ACCOUNT=xxx SNB_KEY=yyy mcp dev src/snbpy_mcp/server.py

# Run directly
SNB_ACCOUNT=xxx SNB_KEY=yyy snbpy-mcp

Publishing

# Build
python -m build

# Upload to PyPI
twine upload dist/*

License

MIT