Skip to main content
Glama

BinanceMCPServer

by AnalyticAce
GitHub
Python
MIT License
26
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Binance MCP Server šŸš€

PyPI version Documentation Status PyPI Deployement Status Python 3.10+ License: MIT

A powerful Model Context Protocol (MCP) server that enables AI agents to interact seamlessly with the Binance cryptocurrency exchange. This server provides a comprehensive suite of trading tools, market data access, and account management capabilities through the standardized MCP interface.

šŸŽÆ Key Features

  • Secure Authentication: API key-based authentication with Binance

  • Real-time Market Data: Live price feeds, order book data, and market statistics

  • Trading Operations: Place, modify, and cancel orders across spot and futures markets

  • Portfolio Management: Account balance tracking, position monitoring, and P&L analysis

  • Smart Notifications: Real-time alerts for price movements, order fills, and market events

  • Risk Management: Built-in safeguards and validation for trading operations

šŸš€ Quick Start

Prerequisites

  • Python 3.10+ installed on your system

  • Binance account with API access enabled

  • API credentials (API Key & Secret) from your Binance account

1ļøāƒ£ Installation

Install the official package from PyPI:

# Recommended: Install using pip pip install binance-mcp-server # Alternative: Using uv for faster package management uv add binance-mcp-server

šŸ’” Why use the PyPI package?

  • āœ… Always up-to-date with latest releases

  • āœ… Automatic dependency management

  • āœ… Simple installation and updates

  • āœ… No need to clone repositories or manage source code

2ļøāƒ£ Configuration

Set up your Binance API credentials as environment variables:

# Required: Your Binance API credentials export BINANCE_API_KEY="your_api_key_here" export BINANCE_API_SECRET="your_api_secret_here" # Recommended: Use testnet for development and testing export BINANCE_TESTNET="true"

3ļøāƒ£ Launch Server

# Start the MCP server (after installing from PyPI) binance-mcp-server --api-key $BINANCE_API_KEY --api-secret $BINANCE_API_SECRET --binance-testnet

4ļøāƒ£ Connect Your AI Agent

Configure your AI agent (Claude, GPT-4, or custom bot) to connect to the MCP server:

{ "mcpServers": { "binance": { "command": "binance-mcp-server", "args": [ "--api-key", "your_api_key", "--api-secret", "your_secret", "--binance-testnet" ] } } }

šŸ“š Available Tools

Our MCP server provides 15 comprehensive trading tools that enable AI agents to perform cryptocurrency trading operations. Each tool follows the Model Context Protocol standard for seamless integration.

šŸ¦ Account & Portfolio Management

Tool

Purpose

get_balance

Retrieve account balances for all assets

get_account_snapshot

Point-in-time account state snapshot

get_fee_info

Trading fee rates (maker/taker commissions) for symbols

get_available_assets

List all tradable cryptocurrencies and exchange info

šŸ“Š Market Data & Analysis

Tool

Purpose

get_ticker_price

Current price for a trading symbol

get_ticker

24-hour ticker price change statistics

get_order_book

Current order book (bids/asks) for a symbol

šŸ’± Trading Operations

Tool

Purpose

create_order

Create buy/sell orders (market, limit, etc.)

get_orders

List order history for a specific symbol

šŸ“ˆ Performance & Analytics

Tool

Purpose

get_pnl

Calculate profit and loss for futures trading

get_position_info

Open futures positions details

šŸŖ Wallet & Transfers

Tool

Purpose

get_deposit_address

Get deposit address for a specific coin

get_deposit_history

Deposit history for a specific coin

get_withdraw_history

Withdrawal history for a specific coin

šŸ›”ļø Risk Management

Tool

Purpose

get_liquidation_history

Past liquidation events for futures trading

šŸ”§ Configuration

Environment Variables

Variable

Description

Required

Default

BINANCE_API_KEY

Your Binance API key

āœ…

-

BINANCE_API_SECRET

Your Binance API secret

āœ…

-

BINANCE_TESTNET

Use testnet environment

āŒ

false

šŸ› ļø Development

šŸ“ Note: This section is for contributors and developers who want to modify the source code. Regular users should install from PyPI using the instructions above.

Development Environment Setup

# 1. Clone the repository git clone https://github.com/AnalyticAce/binance-mcp-server.git cd binance-mcp-server # 2. Create and activate virtual environment python -m venv venv source venv/bin/activate # On Windows: venv\Scripts\activate # 3. Install development dependencies (choose one) # Option A: Using uv (if available) uv install --dev # Option B: Using pip pip install -e . pip install pytest # for testing # 4. Set up pre-commit hooks (optional) pip install pre-commit pre-commit install --hook-type commit-msg # 5. Run tests to verify setup pytest # 6. Start development server python -m binance_mcp_server.cli

Testing Strategy

# Run all tests pytest # Run tests with coverage report pytest --cov=binance_mcp_server --cov-report=html # Run specific test category pytest tests/test_tools/test_account.py -v

šŸ¤ Contributing

We welcome contributions from the crypto and AI development community! Here's how you can help:

šŸŽÆ Current Priorities

Check our GitHub Issues for the latest development priorities:

  • Enhanced Trading Tools - Order cancellation, modification, and advanced order types

  • Portfolio Management - Advanced portfolio analytics and asset allocation tools

  • Risk Management Extensions - Margin monitoring, leverage management, and liquidation alerts

  • Market Data Enhancements - Historical data, technical indicators, and market analysis

  • Alert System - Price notifications and position monitoring

  • Documentation & Examples - Comprehensive guides and use case examples

šŸ“‹ Contribution Guidelines

  1. Fork & Branch: Create a feature branch from main

  2. Code: Follow our coding standards

  3. Pre-commit Hooks: Install and configure pre-commit hooks for commit message validation

  4. Test: Add tests for new features (aim for >80% coverage)

  5. Document: Update documentation for user-facing changes

  6. Review: Submit a pull request for review

šŸ”§ Development Setup for Contributors

šŸ’” For Regular Use: Most users should install via pip install binance-mcp-server instead of cloning this repository.

# Clone your fork git clone https://github.com/your-username/binance-mcp-server.git cd binance-mcp-server # Install dependencies and set up environment (choose one) # Option A: Using uv (if available) uv install --dev # Option B: Using pip pip install -e . pip install pytest pre-commit # Install pre-commit hooks (enforces commit message conventions) pre-commit install --hook-type commit-msg # Make your changes and commit using conventional format git commit -m "feat(tools): add new market data tool"

šŸ·ļø Issue Labels

  • good first issue - Perfect for newcomers

  • enhancement - New features and improvements

  • bug - Something isn't working correctly

  • documentation - Documentation updates needed

  • help wanted - Community assistance requested

šŸ“‹ Development Standards

  • MCP Protocol Compliance: Full adherence to Model Context Protocol standards

  • Pre-commit Hooks: Required for all contributors to ensure commit message consistency

  • Type Hints: Full type annotations required

  • Testing: pytest with >80% coverage target

  • Commits: Conventional commit format (feat:, fix:, etc.) enforced by pre-commit hooks

  • Documentation: Google-style docstrings

  • Security: Comprehensive input validation and secure error handling

šŸ”’ Security & Best Practices

šŸ›”ļø MCP Protocol Compliance

This server implements comprehensive security measures following Model Context Protocol best practices:

  • Enhanced Input Validation: All inputs are validated and sanitized

  • Secure Error Handling: Error messages are sanitized to prevent information leakage

  • Rate Limiting: Built-in protection against API abuse

  • Credential Protection: No sensitive data logged or exposed

  • Audit Logging: Comprehensive security event tracking

šŸ” API Security

  • Credential Management: Never commit API keys to version control

  • Testnet First: Always test with Binance testnet before live trading

  • Rate Limiting: Built-in respect for Binance API rate limits

  • Input Validation: Comprehensive validation of all trading parameters

  • Audit Logging: Complete audit trail of all operations

šŸ” Environment Security

# Use environment variables for sensitive data export BINANCE_API_KEY="your_key_here" export BINANCE_API_SECRET="your_secret_here" # Enable testnet for development export BINANCE_TESTNET="true" # Optional: Configure security features export MCP_RATE_LIMIT_ENABLED="true" export MCP_MAX_REQUESTS_PER_MINUTE="60"

šŸ“– Read Full Security Documentation - Comprehensive security guidelines and best practices.

šŸ’” Usage Examples

šŸ“Š Market Data Queries

# Get real-time Bitcoin price { "name": "get_ticker_price", "arguments": { "symbol": "BTCUSDT" } } # Get 24-hour ticker statistics for Ethereum { "name": "get_ticker", "arguments": { "symbol": "ETHUSDT" } } # Check current order book for Ethereum { "name": "get_order_book", "arguments": { "symbol": "ETHUSDT", "limit": 10 } }

šŸ’° Account Management

# Check account balances { "name": "get_balance", "arguments": {} } # Get account snapshot { "name": "get_account_snapshot", "arguments": { "account_type": "SPOT" } }

šŸ›’ Trading Operations

# Create a limit buy order for Ethereum { "name": "create_order", "arguments": { "symbol": "ETHUSDT", "side": "BUY", "order_type": "LIMIT", "quantity": 0.1, "price": 2000.00 } } # Get order history for a symbol { "name": "get_orders", "arguments": { "symbol": "ETHUSDT" } }

šŸ“ˆ Performance Analysis

# Calculate profit and loss { "name": "get_pnl", "arguments": {} } # Get position information { "name": "get_position_info", "arguments": {} }

šŸŽÆ Roadmap

šŸš€ Phase 1: Core Foundation āœ…

  • MCP Server Framework - FastMCP integration and basic structure

  • MCP Protocol Compliance - Enhanced security and best practices implementation

  • Documentation & Planning - Comprehensive tool specifications

  • Authentication System - Secure Binance API integration

  • Basic Tools Implementation - Essential trading and account tools (15 tools)

  • Security Features - Input validation, error sanitization, rate limiting

šŸ“Š Phase 2: Trading Operations šŸš§

  • Order Management - Basic order creation and history

  • Market Data Integration - Real-time price feeds and order books

  • Portfolio Analytics - Basic P&L tracking and position info

  • Advanced Order Types - Stop-loss, take-profit, OCO orders

  • Order Cancellation - Cancel and modify existing orders

  • Enhanced Risk Management - Advanced margin monitoring

šŸ”„ Phase 3: Advanced Features šŸ“‹

  • Advanced Analytics - Technical indicators and market insights

  • Alert System - Price notifications and position monitoring

  • Strategy Tools - DCA, grid trading, and automation helpers

  • Multi-account Support - Cross-margin, isolated margin accounts

šŸ“ˆ Success Metrics

  • Tool Coverage: 15/15 core tools implemented āœ…

  • Test Coverage: >90% code coverage target (currently 38 tests passing)

  • Security Compliance: MCP best practices implemented āœ…

  • Performance: <100ms average API response time

  • Community: Growing GitHub engagement and contributions

  • Production Usage: Stable package releases on PyPI

šŸ“„ License

This project is licensed under the MIT License - see the LICENSE file for details.

šŸ†˜ Support & Community

šŸ“š Documentation & Resources

šŸ’¬ Get Help

šŸ·ļø Quick Help Tags

When creating issues, please use these labels to help us respond faster:

  • bug - Something isn't working

  • enhancement - Feature requests

  • question - General questions

  • documentation - Docs improvements

  • good first issue - Perfect for newcomers

āš ļø Legal Disclaimer

Important Notice: This software is provided for educational and development purposes only. Cryptocurrency trading involves substantial risk of financial loss.

šŸ“‹ Risk Acknowledgment

  • Testing Environment: Always use Binance testnet for development and testing

  • Financial Risk: Only trade with funds you can afford to lose

  • Due Diligence: Conduct thorough testing before deploying to live trading

  • No Liability: Developers assume no responsibility for financial losses

šŸ“„ License & Attribution

This project is licensed under the MIT License - see the LICENSE file for details.

Built with ā¤ļø by the crypto development community

āš” Powered by

GitHub Stars GitHub Forks GitHub Issues

ā­ Star this project | šŸ“ Fork & Contribute | šŸ“– Read the Docs

This server cannot be installed

-
security - not tested
A
license - permissive license
-
quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

AnalyticAce

  1. šŸŽÆ Key Features
    1. šŸš€ Quick Start
      1. Prerequisites
      2. 1ļøāƒ£ Installation
      3. 2ļøāƒ£ Configuration
      4. 3ļøāƒ£ Launch Server
      5. 4ļøāƒ£ Connect Your AI Agent
    2. šŸ“š Available Tools
      1. šŸ¦ Account & Portfolio Management
      2. šŸ“Š Market Data & Analysis
      3. šŸ’± Trading Operations
      4. šŸ“ˆ Performance & Analytics
      5. šŸŖ Wallet & Transfers
      6. šŸ›”ļø Risk Management
    3. šŸ”§ Configuration
      1. Environment Variables
    4. šŸ› ļø Development
      1. Development Environment Setup
      2. Testing Strategy
    5. šŸ¤ Contributing
      1. šŸŽÆ Current Priorities
      2. šŸ“‹ Contribution Guidelines
      3. šŸ”§ Development Setup for Contributors
      4. šŸ·ļø Issue Labels
      5. šŸ“‹ Development Standards
    6. šŸ”’ Security & Best Practices
      1. šŸ›”ļø MCP Protocol Compliance
      2. šŸ” API Security
      3. šŸ” Environment Security
    7. šŸ’” Usage Examples
      1. šŸ“Š Market Data Queries
      2. šŸ’° Account Management
      3. šŸ›’ Trading Operations
      4. šŸ“ˆ Performance Analysis
    8. šŸŽÆ Roadmap
      1. šŸš€ Phase 1: Core Foundation āœ…
      2. šŸ“Š Phase 2: Trading Operations šŸš§
      3. šŸ”„ Phase 3: Advanced Features šŸ“‹
      4. šŸ“ˆ Success Metrics
    9. šŸ“„ License
      1. šŸ†˜ Support & Community
        1. šŸ“š Documentation & Resources
        2. šŸ’¬ Get Help
        3. šŸ·ļø Quick Help Tags
      2. āš ļø Legal Disclaimer
        1. šŸ“‹ Risk Acknowledgment
        2. šŸ“„ License & Attribution

      Related MCP Servers

      View all related MCP servers

      New MCP Servers

      MCP directory API

      We provide all the information about MCP servers via our MCP API.

      curl -X GET 'https://glama.ai/api/mcp/v1/servers/AnalyticAce/BinanceMCPServer'

      If you have feedback or need assistance with the MCP directory API, please join our Discord server