Aster Finance MCP Server

This project is an MCP (Model Context Protocol) Server that provides a comprehensive set of tools to interact with the Aster Finance Futures API. It allows AI agents and other MCP-compatible clients to access market data, manage trades, and query account information on the Aster exchange.

Features

• Full REST API Coverage: Implements all RESTful endpoints from the Aster Futures API documentation (excluding WebSocket streams).

• Market Data: Access real-time and historical market data, including order books, trades, klines, and ticker information.

• Account & Trading: Full trading capabilities, including placing/canceling orders, managing positions, and checking account balances.

• Secure: Uses API keys stored securely as environment variables, never hardcoded.

• Stdio Transport: Runs as a standard I/O process, making it easy to integrate with MCP hosts.

Related MCP server: AsterDex MCP Server

Installation & Configuration

This server is designed to be run by an MCP host environment.

1. Install Dependencies & Build:

   You can use either npm or pnpm to install the project dependencies and build the server.

   Using npm:

   npm install
   npm run build

   Or using pnpm:

   pnpm install
   pnpm run build

2. Configure the MCP Host: Add the following configuration to your MCP settings file (e.g., cline_mcp_settings.json). This tells the host how to launch the server and provides the necessary API credentials.

   {
     "mcpServers": {
       "aster": {
         "command": "node",
         "args": [
           "/path/to/your/aster-mcp-server/build/index.js"
         ],
         "env": {
           "ASTER_API_KEY": "YOUR_ASTER_API_KEY",
           "ASTER_API_SECRET": "YOUR_ASTER_SECRET_KEY"
         },
         "disabled": false,
         "autoApprove": []
       }
     }
   }

   Replace /path/to/your/aster-mcp-server with the absolute path to this project directory, and fill in your actual ASTER_API_KEY and ASTER_API_SECRET.

Available Tools

The server exposes the following tools, categorized by function:

Market Data Endpoints

Account & Trade Endpoints

Usage Example

Once the server is running, you can invoke its tools through your MCP client. For example, to get the current server time, you would make a callTool request like this:

{
  "server_name": "aster",
  "tool_name": "time",
  "arguments": {}
}

To get the order book for BTCUSDT:

{
  "server_name": "aster",
  "tool_name": "depth",
  "arguments": {
    "symbol": "BTCUSDT",
    "limit": 10
  }
}

This MCP Server was proudly developed with the assistance of Questflow.