binance-mcp

# Binance MCP Server This is a starting point for a Binance trading interface server based on MCP (Model Control Protocol). It provides a series of basic Binance exchange interaction capabilities and can serve as the foundation for developing more complex trading strategies and functions. ## Features The currently implemented basic functions include: - Real-time cryptocurrency price acquisition - Query account asset balance - Order placement (market order) - Query transaction history - Query current open orders - Cancel order - Get funding rate history - Execute hedge arbitrage strategy - Automatically find arbitrage opportunities These features provide you with the basic building blocks to develop more advanced trading strategies and automated systems. You can use these interfaces to: - Develop more complex trading strategies - Add risk management systems - Implement more types of order support - Expand data analysis capabilities - Add custom arbitrage strategies ## Installation Requirements - Python >= 3.13 - mcp[cli] >= 1.6.0 - requests >= 2.32.3 ## Installation and Configuration 1. Clone the repository: ```bash git clone https://github.com/mixuechu/binance-mcp.git cd binance-mcp-server ``` 2. Create and activate a virtual environment 3. Install dependencies: uv sync 4. Configure MCP: In your MCP configuration file (usually located at `~/.cursor/mcp.json`), add the following configuration: ```json { "binance-mcp": { "command": "uv", "args": [ "--directory", "/path/to/binance-mcp-server", "run", "binance.py", "--binance-api-key", "YOUR_API_KEY", "--binance-secret-key", "YOUR_SECRET_KEY" ] } } ``` ## Usage 1. Make sure you have created an API key on Binance and configured it correctly in the MCP configuration file. 2. Call the functions provided by the service through the MCP client: - `get_symbol_price`: Get the current price of a trading pair - `get_account_balance`: Query the account balance of a specific cryptocurrency - `place_market_order`: Place a market order - `get_trade_history`: Get transaction history - `get_open_orders`: Query open orders - `cancel_order`: Cancel order - `get_funding_rate_history`: Get funding rate history - `execute_hedge_arbitrage_strategy`: Execute hedge arbitrage strategy - `find_arbitrage_pairs`: Find arbitrage opportunities ## Development and Expansion This project provides a basic trading function framework, you can: 1. Add new trading strategies 2. Expand existing functions 3. Add more error handling and logging 4. Implement more complex arbitrage logic 5. Integrate APIs from other exchanges ## Security Tips - Please keep your API key and secret key safe - It is recommended to set appropriate API permission restrictions when using - Before making actual transactions, it is recommended to test on the test network first ## Contribution Welcome to submit issues and merge requests. This project is under active development and we welcome any form of contribution. ## License MIT