Add Binance MCP Server project

[AnalyticAce]

Description

This pull request adds comprehensive trading functionality to the Binance MCP Server, implementing 17 powerful tools that enable AI agents to interact seamlessly with Binance's cryptocurrency exchange API. The server provides secure authentication, real-time market data access, portfolio management capabilities, and trading operations through the standardized Model Context Protocol interface. This implementation supports both spot and futures trading, includes risk management features, and offers complete account management functionality for AI-driven cryptocurrency trading applications.

Server Details

• Server: https://github.com/AnalyticAce/BinanceMCPServer, https://analyticace.github.io/BinanceMCPServer/, https://pypi.org/project/binance-mcp-server/
• Package Name: binance-mcp-server
• Framework: Built with FastMCP for MCP compliance
• API Integration: Binance API v3 (spot and futures)
• Changes to:
  • Tools: 17 comprehensive trading and market data tools
  • Resources: Secure API authentication, rate limiting, error handling
  • Prompts: Enhanced user interaction for trading operations

Motivation and Context

This implementation addresses the critical need for AI agents to access cryptocurrency trading capabilities through a standardized, secure interface. The crypto trading landscape requires sophisticated tools for:

• Real-time Market Analysis: AI agents need access to live price data, order books, and market statistics for informed decision-making
• Automated Trading Operations: Enables creation, modification, and cancellation of orders across multiple trading pairs
• Portfolio Management: Comprehensive account balance tracking, position monitoring, and P&L analysis for risk management
• Security & Compliance: Implements MCP security best practices with input validation, rate limiting, and secure error handling
• Educational Development: Provides testnet support for safe development and testing of trading algorithms

The server bridges the gap between advanced AI capabilities and cryptocurrency market access, enabling developers to build sophisticated trading bots and automated investment strategies.

How Has This Been Tested?

Testing Environment:

• Binance testnet environment for safe development testing
• Limited production API testing with minimal fund exposure
• Comprehensive unit and integration test suite (38+ tests passing)

LLM Client Integration:

• Claude Desktop: Full MCP client integration tested with all 17 tools
• Custom MCP Clients: Tested STDIO transport communication
• API Response Validation: All tools tested for proper JSON response formatting

Specific Test Scenarios:

• Authentication Flow: API key validation and secure connection establishment
• Market Data Retrieval: Real-time price feeds, ticker data, and order book access
• Trading Operations: Order creation (market/limit), order history retrieval, fee calculations
• Portfolio Management: Balance checking, account snapshots, P&L calculations
• Futures Trading: Position monitoring, liquidation history, margin management
• Error Handling: Invalid parameters, rate limiting, network errors, API failures
• Security Validation: Input sanitization, credential protection, secure logging

Performance Metrics:

• Average API response time: <100ms
• Test coverage: >90% code coverage
• Rate limiting compliance: Respects Binance API limits

Breaking Changes

Configuration Updates Required:

Users will need to update their MCP client configurations to include the new server. This is not a breaking change to existing functionality, but rather a new server addition.

Required MCP Client Configuration:

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

Environment Variables Setup:

export BINANCE_API_KEY="your_api_key_here"
export BINANCE_API_SECRET="your_api_secret_here"
export BINANCE_TESTNET="true"  # Recommended for development

No existing MCP servers or configurations will be affected by this addition.

Types of changes

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to change)
• Documentation update

Checklist

• I have read the [MCP Protocol Documentation](https://modelcontextprotocol.io)
• My changes follows MCP security best practices
• I have updated the server's README accordingly
• I have tested this with an LLM client
• My code follows the repository's style guidelines
• New and existing tests pass locally
• I have added appropriate error handling
• I have documented all environment variables and configuration options

Additional context

Technical Implementation Details:

Architecture:

• Built on FastMCP framework for optimal MCP protocol compliance
• Utilizes python-binance library for robust API integration
• Implements async/await patterns for non-blocking operations
• Comprehensive error handling with sanitized error messages

Security Features:

• Input Validation: All trading parameters validated before API calls
• Rate Limiting: Built-in protection against Binance API rate limits
• Credential Protection: API keys never logged or exposed in error messages
• Audit Logging: Complete audit trail of all trading operations
• Testnet First: Strongly encourages testnet usage for development

Tool Categories Implemented:

1. Account Management (4 tools): Balance checking, account snapshots, fee information, asset listings
2. Market Data (3 tools): Real-time prices, 24-hour statistics, order book data
3. Trading Operations (2 tools): Order creation and history management
4. Futures Trading (2 tools): P&L tracking and position monitoring
5. Banking Operations (3 tools): Deposit/withdrawal address and history
6. Risk Management (1 tool): Liquidation history tracking
7. Additional Tools (2 tools): Extensible for future enhancements

Installation & Quick Start:

# Install from PyPI (recommended approach)
pip install binance-mcp-server

# Start the server with testnet
binance-mcp-server --api-key YOUR_KEY --api-secret YOUR_SECRET --binance-testnet

@domdomegg @olaservo

[claude]

Thank you @AnalyticAce for your contribution! 🎉

Your Binance MCP server has been accepted and included as part of our batch integration in PR #2553. We really appreciate you taking the time to submit this integration.

The server is now officially listed in our README and available to the community!