chnyangjie-snbpy-mcp

# 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: ```json { "mcpServers": { "chnyangjie-snbpy": { "command": "uvx", "args": ["chnyangjie-snbpy-mcp"], "env": { "SNB_ACCOUNT": "YOUR_ACCOUNT", "SNB_KEY": "YOUR_KEY" } } } } ``` ### Option 2: pip install ```bash 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 ```bash # 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 ```bash # Buil…