aiowhitebit-mcp

# aiowhitebit-mcp Message Control Protocol (MCP) server and client implementation for WhiteBit cryptocurrency exchange API. Built on top of [aiowhitebit](https://github.com/doubledare704/aiowhitebit) library and [fastmcp](https://github.com/jlowin/fastmcp). ## Features - MCP server for WhiteBit API with public endpoints - Support for multiple transport protocols (stdio, SSE, WebSocket) - Easy-to-use client for interacting with the MCP server - Command-line interface for running the server - Integration with Claude Desktop - Real-time market data via WebSocket - Comprehensive test coverage and type checking - Modern development tools (ruff, pyright, pre-commit) - Caching with disk persistence - Rate limiting and circuit breaker patterns ### New in aiowhitebit 0.3.0 Integration - **BookTicker WebSocket Streams**: Real-time best bid/ask price updates - **Funding History for Futures**: Access historical funding rates for futures markets - **Enhanced WebSocket Events**: All WebSocket events now include optional metadata (event_time, update_id) ## Quick Start ```bash # Install the package pip install aiowhitebit-mcp # Run the server (stdio transport for Claude Desktop) aiowhitebit-mcp --transport stdio # Or run with SSE transport aiowhitebit-mcp --transport sse --host 127.0.0.1 --port 8000 ``` ## Basic Usage ### Client with Network Transport ```python import asyncio import os from aiowhitebit_mcp.client import WhiteBitMCPClient async def main(): # Set the server URL (or use environment variable) server_url = "http://localhost:8000/sse" os.environ["WHITEBIT_MCP_URL"] = server_url async with WhiteBitMCPClient() as client: # Get market info btc_usdt = await client.get_market_resource("BTC_USDT") print("BTC/USDT Market Info:", btc_usdt) # Get real-time price via WebSocket price = await client.get_last_price("BTC_USDT") print("Current BTC/USDT price:", price) # Get order book order…