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

Tools

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