snbgo-mcp

npm package for the Snowball Securities (雪盈证券) MCP server. Wraps the Go binary with zero npm dependencies — npx snbgo-mcp is all you need.

Install

npx -y snbgo-mcp

No npm dependencies. The package bundles pre-compiled Go binaries for 6 platforms (darwin/linux/windows × amd64/arm64). The postinstall script copies the correct binary for your platform.

MCP Client Configuration

Claude Desktop / Cursor / Windsurf

Add to your MCP settings:

{
  "mcpServers": {
    "snbgo-mcp": {
      "command": "npx",
      "args": ["-y", "snbgo-mcp"],
      "env": {
        "SNB_ACCOUNT": "your_account_id",
        "SNB_KEY": "your_secret_key"
      }
    }
  }
}

macOS — Claude Desktop config location

~/Library/Application Support/Claude/claude_desktop_config.json

Environment Variables

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | SNB_ACCOUNT | Yes | - | Snowball Securities account ID | | SNB_KEY | Yes | - | API secret key | | SNB_SERVER | No | sandbox.snbsecurities.com | API host | | SNB_PORT | No | 443 | API port | | SNB_SCHEMA | No | https | http or https | | SNB_TIMEOUT | No | 10000 | Request timeout (ms) |

Available MCP Tools

Once connected, your AI tool has access to:

| Tool | Description | |------|-------------| | login | Login and obtain access token | | get_token_status | Check token expiry status | | place_order | Place a trade order | | cancel_order | Cancel an existing order | | get_order_by_id | Query a single order | | get_order_list | List orders with pagination | | get_transaction_list | Query transaction history | | get_balance | Query account balance | | get_position_list | Query current positions | | get_security_detail | Look up security details |

Supported Platforms

| Platform | Architecture | |----------|-------------| | macOS | Intel (amd64), Apple Silicon (arm64) | | Linux | x64 (amd64), ARM64 (arm64) | | Windows | x64 (amd64), ARM64 (arm64) |

How It Works

1. npm install triggers install.js (postinstall hook)
2. install.js detects your platform and copies the matching pre-compiled Go binary to bin/snbgo-mcp
3. npx snbgo-mcp runs bin/run.js, which spawns the Go binary with stdio passthrough
4. The Go binary starts the MCP server, communicates via JSON-RPC over stdio

If no bundled binary matches your platform, a warning is printed with a link to GitHub Releases for manual download.

License

Apache License 2.0