加密货币数据服务器

git clone https://github.com/yourusername/crypto-mcp-server.git
cd crypto-mcp-server

# Windows
python -m venv venv
.\venv\Scripts\activate

# Linux/Mac
python3 -m venv venv
source venv/bin/activate

pip install --upgrade pip
pip install -r requirements.txt

# Copy environment template
cp .env.example .env

# Edit .env with your preferred settings
# (Optional: Add API keys for private endpoints)

# Start the MCP server
python -m src.server

# Or use the entry point (after installation)
crypto-mcp-server

from src.crypto_client import CryptoClient

# Create client
client = CryptoClient('binance')

# Get current BTC price
ticker = client.get_ticker('BTC/USDT')
print(f"BTC Price: ${ticker['last']}")

# Get historical data
df = client.get_ohlcv('BTC/USDT', timeframe='1d', limit=30)
print(df.head())

# Search for symbols
symbols = client.search_symbols('BTC')
print(f"Found {len(symbols)} BTC pairs")

crypto-mcp-server/
├── src/
│   ├── __init__.py
│   ├── server.py           # Main MCP server
│   ├── crypto_client.py    # CCXT integration
│   ├── cache_manager.py    # Caching layer
│   └── config.py           # Configuration management
├── tests/
│   ├── __init__.py
│   ├── test_server.py      # Server tests
│   ├── test_crypto_client.py  # Client tests
│   ├── test_cache_manager.py  # Cache tests
│   └── test_integration.py    # Integration tests
├── requirements.txt
├── setup.py
├── .env.example
├── .gitignore
└── README.md

pytest

pytest tests/test_crypto_client.py -v

pytest --cov=src --cov-report=html

# Cache Configuration
CACHE_ENABLED=true
CACHE_TTL=300              # 5 minutes
CACHE_MAX_SIZE=1000
CACHE_DIR=.cache

# Exchange Configuration
DEFAULT_EXCHANGE=binance
RATE_LIMIT=true
REQUEST_TIMEOUT=30000      # 30 seconds

# Server Configuration
SERVER_HOST=localhost
SERVER_PORT=8000
DEBUG=false
LOG_LEVEL=INFO

# API Keys (Optional)
COINMARKETCAP_API_KEY=your_key_here

from src.config import config

# Access configuration
print(config.cache.ttl)
print(config.exchange.default_exchange)

# Validate configuration
config.validate_config()

ticker = client.get_ticker('BTC/USDT')
# Returns: {last, bid, ask, high, low, volume, change, ...}

orderbook = client.get_orderbook('BTC/USDT', limit=50)
# Returns: {bids: [[price, amount], ...], asks: [[price, amount], ...]}

df = client.get_ohlcv('BTC/USDT', timeframe='1h', limit=24)
# Returns: DataFrame with [timestamp, open, high, low, close, volume]

df = client.get_historical_data('BTC/USDT', timeframe='1d', days=90)
# Returns: DataFrame with up to 90 days of data

value = cache_manager.get('my_key')

cache_manager.set('my_key', data, ttl=300)

data = cache_manager.get_cached_or_fetch(
    'ticker:BTC',
    fetch_function,
    'BTC/USDT'
)

┌─────────────────┐
│   MCP Server    │  ← Handles tool calls
└────────┬────────┘
         │
    ┌────▼─────┐
    │  Client  │  ← CCXT integration
    └────┬─────┘
         │
    ┌────▼─────┐
    │  Cache   │  ← Performance layer
    └──────────┘

pip install -r requirements.txt

from src.config import config
print(config.exchange.supported_exchanges)

# Check .env file
CACHE_ENABLED=true

RATE_LIMIT=true

# Install development dependencies
pip install -r requirements.txt

# Run tests with coverage
pytest --cov=src --cov-report=html

# Format code
black src/ tests/

# Lint code
flake8 src/ tests/

# Type checking
mypy src/