MMCPMarkets
AA

asterdex/aster-mcp

Developer tools
45 stars 0 forks 품질 70 트렌드 70
Repository Install

An Model Context Protocol server for APIs, enabling AI agents (e.g. Cursor, Claude, LangChain) to securely query market data, place orders, and check positions and accounts.

개요

An Model Context Protocol server for APIs, enabling AI agents (e.g. Cursor, Claude, LangChain) to securely query market data, place orders, and check positions and accounts.

README

Aster MCP Server

An Model Context Protocol server for Aster Futures and Spot APIs, enabling AI agents (e.g. Cursor, Claude, LangChain) to securely query market data, place orders, and check positions and accounts.

Features

  • Config & security: Multi-account, local Fernet-encrypted API key storage (~/.config/aster-mcp/)
  • Auth: HMAC (API Key/Secret) and V3 key signing (EIP-712, user/signer/private_key; see aster-finance-futures-api-v3)
  • MCP tools:
    • Futures: Market data, account/positions, place/cancel orders, leverage & margin, transfers, income, commission rate, leverage bracket
    • Spot: Market data, account, place/cancel orders, trades, transaction history, commission rate, spot–futures transfer
  • CLI: config / list / start / stop / status / test / backup

Installation

pip install -e .
# or
pip install git+https://github.com/asterdex/aster-mcp.git

Quick start

# 1. Configure account (interactive, default HMAC)
aster-mcp config

# V3 key-signing account (EIP-712)
aster-mcp config --account-id main --auth-type v3

# 2. List accounts
aster-mcp list

# 3. Start MCP service (default stdio for Cursor/Claude)
aster-mcp start

# 4. Test connection
aster-mcp test main

Using with Cursor

  1. Configure at least one account with aster-mcp config.
  2. Add Aster MCP in Cursor’s MCP settings; command example:
    • python -m aster_mcp.simple_server (use a Python environment where aster_mcp is installed).
  3. Use natural language in chat (e.g. “get Aster BTC price”, “place an Aster order”).

Tool list (summary)

Category Futures tools Spot tools
Market get_ticker, get_order_book, get_klines, get_funding_rate, get_funding_info, get_exchange_info, ping get_spot_ticker, get_spot_price, get_spot_order_book, get_spot_klines, get_spot_exchange_info
Account get_balance, get_positions, get_account_info, get_account_v4 get_spot_account
Orders create_order, cancel_order, cancel_all_orders, get_order, get_open_orders, get_all_orders, get_my_trades create_spot_order, cancel_spot_order, cancel_spot_all_orders, get_spot_order, get_spot_open_orders, get_spot_all_orders, get_spot_my_trades
Other set_leverage, set_margin_mode, transfer_funds, get_income, get_commission_rate, get_leverage_bracket get_spot_transaction_history, get_spot_commission_rate, transfer_spot_futures
System get_server_info

Full parameters and integration details: Aster-MCP External Integration Guide.

Project structure

aster-mcp/
├── aster_mcp/
│   ├── __init__.py
│   ├── config.py       # Config & encryption
│   ├── client.py       # Aster FAPI client (futures, HMAC)
│   ├── v3_client.py    # Aster FAPI v3 client (EIP-712)
│   ├── spot_client.py  # Aster SAPI client (spot)
│   ├── tools.py        # MCP tool implementations
│   ├── simple_server.py
│   └── cli.py
├── docs/
│   └── Aster-MCP-External-Integration.md
├── tests/
├── pyproject.toml
├── requirements.txt
└── README.md

Relation to Aster APIs

  • This repo includes Aster FAPI (client.py, futures) and SAPI (spot_client.py, spot) clients.
  • Auth:
    • HMAC: API Key/Secret for /fapi/v1, /fapi/v2, etc.
    • V3 key signing: user (main wallet), signer (API wallet), private_key (signer key), EIP-712; for /fapi/v3. Requires eth-account.
  • Futures base URL: https://fapi.asterdex.com; Spot base URL: https://sapi.asterdex.com (overridable per account in config).
  • API docs: aster-finance-futures-api, aster-finance-futures-api-v3, aster-finance-spot-api.

Risk and compliance

  • Futures trading involves risk; verify in a test environment first.
  • API keys are stored locally with encryption; do not leak or commit them.
  • Comply with local regulations and Aster platform terms.

License

MIT

View this README on GitHub

설치

This server does not publish a one-line install command.

Open the repository installation guide