Binance MCP Server

A comprehensive FastMCP server implementation providing datetime utilities and Binance API integration tools for cryptocurrency market operations.

Features

🕒 DateTime Tools: Get current date and time in ISO8601 format
📈 Binance API Integration: Direct connectivity to Binance cryptocurrency exchange
🔄 Connectivity Testing: Test Binance API connectivity and server time sync
🚀 FastMCP Framework: Built with FastMCP for efficient MCP server implementation
⚙️ Configuration Management: Environment-based configuration with dotenv support
📊 Observability: Logfire integration for monitoring and debugging

Related MCP server: Upbit MCP Server

Installation

Requirements

Python 3.8+
Dependencies listed in pyproject.toml

Setup

# Install dependencies using rye (recommended) rye sync # Or using uv uv sync

Environment Configuration

Create a .env file in the project root:

# Server Configuration PORT=8000 TRANSPORT=http # Binance API Credentials (optional for basic tools) BINANCE_API_KEY=your_api_key_here BINANCE_API_SECRET=your_api_secret_here # Observability (optional) LOGFIRE_TOKEN=your_logfire_token_here

Note: API credentials are only required for authenticated Binance operations. Basic tools like datetime and connectivity testing work without credentials.

Usage

Running the Server

Standalone Mode

# Run the server directly python -m binance_mcp.main # Or use the installed script mcp # For development (from project root) python -m src.binance_mcp.main

With MCP Client (e.g., Claude Desktop)

Add to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json):

{ "mcpServers": { "binance-mcp": { "command": "python", "args": ["-m", "binance_mcp.main"], "cwd": "/path/to/binance-mcp", "env": { "BINANCE_API_KEY": "your_api_key", "BINANCE_API_SECRET": "your_api_secret" } } } }

Available Tools

`get_current_datetime`

Returns the current date and time in ISO8601 format.

Parameters: None

Response:

timestamp (string): Current date and time in ISO8601 format

Example Response:

{ "timestamp": "2025-08-18T23:01:41.949232+00:00" }

`binance_test_connectivity`

Tests connectivity to the Binance API endpoints.

Parameters: None

Response:

timestamp (string): ISO8601 timestamp when the test was performed
reachable (boolean): True if Binance API is reachable, False otherwise

Example Response:

{ "timestamp": "2025-08-18T23:01:41.949232+00:00", "reachable": true }

`get_binance_server_time`

Retrieves the current server time from Binance.

Parameters: None

Response:

server_time (integer): Unix timestamp in milliseconds representing Binance server time

Example Response:

{ "server_time": 1692396701949 }

Development

Project Structure

binance-mcp/ ├── src/ │ └── binance_mcp/ │ ├── __init__.py │ ├── main.py # Main MCP server implementation │ ├── models.py # Pydantic response models │ ├── settings.py # Configuration management │ ├── client.py # Binance client factory │ └── tools/ │ ├── __init__.py │ └── timestamp.py # DateTime and Binance time tools ├── pyproject.toml # Project configuration ├── .env # Environment variables (create from template) └── README.md # This file

Testing

Test the server functionality:

# Test individual tools (requires server to be running) # The FastMCP framework provides built-in testing capabilities # Run the server in development mode rye run mcp # Or if the virtualenv is activated mcp # Or use ruff for code quality checks rye run ruff check src/

Future Enhancements

Market data tools (ticker prices, order book, candlestick data)
Account information tools (balances, trading history)
Trading operations (place orders, cancel orders)
WebSocket streaming tools for real-time data
Additional cryptocurrency exchange integrations
Rate limiting and advanced error handling
Caching mechanisms for frequently accessed data
Portfolio analytics and reporting tools

License

[Add your license here]

Contributing

[Add contribution guidelines if needed]

Binance MCP Server

Binance MCP Server

Features

Installation

Requirements

Setup

Environment Configuration

Usage

Running the Server

Standalone Mode

With MCP Client (e.g., Claude Desktop)

Available Tools

`get_current_datetime`

`binance_test_connectivity`

`get_binance_server_time`

Development

Project Structure

Testing

Future Enhancements

License

Contributing

Resources

New MCP Servers

Latest Blog Posts

MCP directory API