crypto-powerdata-mcp
Provides access to Binance exchange data, including candlestick data and real-time prices, through CCXT integration.
Provides access to Coinbase exchange data, including candlestick data and real-time prices, through CCXT integration.
Provides access to decentralized exchange (DEX) market data via the OKX DEX API, including candlestick data and real-time token prices. Also supports centralized exchange data from OKX through CCXT.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@crypto-powerdata-mcpget BTC/USDT daily candles from Binance with EMA 20 and RSI 14"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Crypto PowerData MCP Service
A comprehensive MCP (Model Context Protocol) service for cryptocurrency data acquisition with advanced technical analysis capabilities
🚀 Quick Start with uvx (Recommended)
No installation required! Run directly with uvx:
# Run MCP server for Claude Desktop/MCP Studio
uvx crypto-powerdata-mcp
# Run HTTP server for web access
uvx crypto-powerdata-mcp --http
# Run with OKX API credentials
uvx crypto-powerdata-mcp --env OKX_API_KEY=your_key --env OKX_SECRET_KEY=your_secretClaude Desktop Configuration:
{
"mcpServers": {
"crypto-powerdata": {
"command": "uvx",
"args": ["crypto-powerdata-mcp"],
"env": {
"OKX_PROJECT_ID": "your_okx_project_id",
"OKX_API_KEY": "your_okx_api_key",
"OKX_SECRET_KEY": "your_okx_secret_key",
"OKX_PASSPHRASE": "your_okx_passphrase"
}
}
}
}📖 See QUICK_START.md for complete uvx usage guide
Related MCP server: coin-mcp
📋 Table of Contents
🎯 Overview
The Crypto PowerData MCP Service is an advanced cryptocurrency data acquisition service that provides:
Comprehensive TA-Lib Integration: 158 technical indicators across 10 categories
Dual Transport Support: Both stdio and HTTP/SSE protocols
Multi-Exchange Access: 100+ centralized exchanges via CCXT
DEX Integration: Real-time decentralized exchange data via OKX DEX API
Flexible Parameters: Multiple instances of indicators with different parameters
Intelligent Labeling: Automatic column naming based on parameters
Key Capabilities
🔄 Dual Transport Protocols
stdio transport - Standard input/output for command-line and programmatic access
HTTP/SSE transport - Server-Sent Events for web applications and real-time data feeds
Auto-detection - Automatically chooses appropriate transport method
Identical functionality - Same tools and features across both protocols
📊 Data Sources
CEX Data - Candlestick data from 100+ centralized exchanges (CCXT)
DEX Data - Candlestick data from decentralized exchanges (OKX DEX API)
Real-time Prices - Current token prices from DEX markets
🧮 Technical Analysis
158 TA-Lib indicators with flexible multi-parameter support
Enhanced parameter format:
{'ema': [{'timeperiod': 12}, {'timeperiod': 26}]}Intelligent result labeling:
ema_12,ema_26,macd_12_26_9
✨ Features
🔄 Dual Transport Architecture
stdio Transport: Standard MCP protocol for command-line tools and local integrations
HTTP/SSE Transport: RESTful API with Server-Sent Events for web applications
Auto-Detection: Intelligent transport selection based on environment
Session Management: Persistent sessions with proper cleanup
📊 Comprehensive Technical Analysis
158 TA-Lib Indicators across 10 categories (Momentum, Overlap, Pattern Recognition, etc.)
Multi-Parameter Support: Multiple instances of same indicator with different parameters
Flexible Configuration: JSON-based parameter specification with validation
Intelligent Labeling: Automatic column naming (e.g.,
ema_12,macd_12_26_9)
🌐 Multi-Exchange Support
100+ CEX Exchanges: Via CCXT library (Binance, Coinbase, Kraken, etc.)
DEX Integration: OKX DEX API for decentralized exchange data
Real-time Data: Current prices and historical candlestick data
Multiple Timeframes: From 1 minute to 1 month intervals
🛡️ Robust Parameter Handling
String Parameter Processing: Handles MCP client string inputs
JSON Parsing: Supports various JSON formats and error correction
Validation: Comprehensive parameter validation with helpful error messages
Type Conversion: Automatic conversion between string and native types
🏗️ Architecture
graph TB
A[MCP Client] --> B{Transport Layer}
B -->|stdio| C[FastMCP Server]
B -->|HTTP/SSE| D[Dual Transport Server]
C --> E[MCP Bridge]
D --> E
E --> F[Tool Functions]
F --> G[Data Provider]
F --> H[Enhanced Indicators]
G --> I[CCXT - CEX Data]
G --> J[OKX DEX API]
H --> K[TA-Lib Registry]
I --> L[100+ Exchanges]
J --> M[DEX Markets]
K --> N[158 Indicators]Core Components
MCP Bridge: Unified interface between transport protocols and business logic
Data Provider: Handles data fetching from CEX and DEX sources
Enhanced Indicators: Advanced technical analysis with flexible parameters
TA-Lib Registry: Complete registry of all available indicators with metadata
Dual Transport Server: HTTP/SSE server with session management
🚀 Quick Start
Prerequisites
Python 3.10+ installed on your system
UV package manager (installation guide)
Git for cloning the repository
1. Installation
# Clone the repository
git clone https://github.com/veithly/crypto-powerdata-mcp.git
cd crypto-powerdata-mcp
# Install dependencies using UV
uv sync
# Verify installation
uv run python -c "import src.main; print('✅ Installation successful!')"2. Basic Usage
Option A: stdio Transport (Default)
# Start the MCP service
uv run python -m src.main
# Test with the provided test script
uv run python test_mcp_functionality.pyOption B: HTTP/SSE Transport
# Start HTTP server
uv run python -m src.main --http
# Access endpoints:
# - API: http://localhost:8000/mcp
# - Health: http://localhost:8000/health
# - Documentation: http://localhost:8000/Option C: Auto-Detection Mode
# Let the server choose the best transport
uv run python -m src.dual_transport_server --mode auto3. First API Call
import asyncio
import json
from mcp import ClientSession, StdioServerParameters
from mcp.client.stdio import stdio_client
async def test_basic_functionality():
server_params = StdioServerParameters(
command="uv",
args=["run", "python", "-m", "src.main"],
cwd=".",
env={"PYTHONPATH": "."}
)
async with stdio_client(server_params) as (read, write):
async with ClientSession(read, write) as session:
await session.initialize()
# Get available indicators
result = await session.call_tool("get_available_indicators", {})
print(f"Available indicators: {len(json.loads(result.content[0].text))}")
if __name__ == "__main__":
asyncio.run(test_basic_functionality())📦 Installation
System Requirements
Operating System: Windows 10+, macOS 10.15+, or Linux (Ubuntu 18.04+)
Python: 3.10 or higher
Memory: Minimum 2GB RAM (4GB recommended for large datasets)
Storage: 500MB free space for dependencies
Dependencies
The service automatically installs the following key dependencies:
MCP Framework:
mcp>=1.0.0- Model Context Protocol implementationCCXT:
ccxt>=4.0.0- Cryptocurrency exchange trading libraryTA-Lib:
ta-lib>=0.4.25- Technical analysis libraryFastAPI:
fastapi>=0.104.0- Modern web framework for HTTP transportPandas:
pandas>=2.0.0- Data manipulation and analysisNumPy:
numpy>=1.24.0- Numerical computing
Installation Methods
Method 1: Direct Usage with uvx (Recommended) ⭐
No installation required! Run directly without cloning:
# Run MCP server (stdio mode for Claude Desktop)
uvx crypto-powerdata-mcp
# Run HTTP server for web access
uvx crypto-powerdata-mcp --http
# Run with environment variables
uvx crypto-powerdata-mcp --env OKX_API_KEY=your_key --env OKX_SECRET_KEY=your_secretAdvantages:
✅ No repository cloning needed
✅ No dependency management
✅ Always uses latest published version
✅ Automatic isolation
✅ Works across different environments
Method 2: Local Development Installation
# Install UV if not already installed
curl -LsSf https://astral.sh/uv/install.sh | sh
# Clone and install
git clone https://github.com/veithly/crypto-powerdata-mcp.git
cd crypto-powerdata-mcp
uv syncMethod 3: Using pip
git clone https://github.com/veithly/crypto-powerdata-mcp.git
cd crypto-powerdata-mcp
pip install -e .Method 4: Development Installation with Testing
git clone https://github.com/veithly/crypto-powerdata-mcp.git
cd crypto-powerdata-mcp
uv sync --dev # Includes development dependenciesTA-Lib Installation
TA-Lib requires additional system-level installation:
Windows
# Using conda (recommended)
conda install -c conda-forge ta-lib
# Or download pre-compiled wheels
pip install TA-LibmacOS
brew install ta-lib
pip install TA-LibLinux (Ubuntu/Debian)
sudo apt-get install libta-lib-dev
pip install TA-Lib⚙️ Configuration
Environment Variables
Create a .env file in the project root for configuration:
# OKX DEX API Configuration (Required for DEX features)
OKX_API_KEY=your_api_key_here
OKX_SECRET_KEY=your_secret_key_here
OKX_API_PASSPHRASE=your_passphrase_here
OKX_PROJECT_ID=your_project_id_here
# Optional Performance Settings
RATE_LIMIT_REQUESTS_PER_SECOND=10
TIMEOUT_SECONDS=30
LOG_LEVEL=INFO
# Optional Transport Settings
DEFAULT_TRANSPORT=stdio
HTTP_HOST=127.0.0.1
HTTP_PORT=8000OKX API Setup
Create OKX Account: Visit OKX and create an account
Generate API Keys: Go to API Management in your account settings
Enable DEX API: Ensure DEX API access is enabled for your API key
Configure Permissions: Set appropriate permissions for market data access
MCP Client Configuration
Claude Desktop Configuration
Add to your Claude Desktop configuration file:
{
"mcpServers": {
"crypto-powerdata-mcp": {
"command": "uv",
"args": ["run", "python", "-m", "src.main"],
"cwd": "/absolute/path/to/crypto-powerdata-mcp",
"env": {
"PYTHONPATH": ".",
"OKX_API_KEY": "your_api_key",
"OKX_SECRET_KEY": "your_secret_key",
"OKX_API_PASSPHRASE": "your_passphrase",
"OKX_PROJECT_ID": "your_project_id"
}
}
}
}MCP Studio Configuration
{
"name": "Crypto PowerData MCP",
"command": ["uv", "run", "python", "-m", "src.main"],
"env": {
"PYTHONPATH": "/path/to/crypto-powerdata-mcp"
}
}💡 Usage Examples
Basic Examples
1. Get Real-time Token Price
# Get current USDC price on Ethereum
result = await session.call_tool("get_dex_token_price", {
"chain_index": "1", # Ethereum
"token_address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48" # USDC
})2. Fetch CEX Data with Indicators
# Get BTC/USDT data from Binance with technical indicators
result = await session.call_tool("get_cex_data_with_indicators", {
"exchange": "binance",
"symbol": "BTC/USDT",
"timeframe": "1h",
"limit": 100,
"indicators_config": '{"ema": [{"timeperiod": 12}, {"timeperiod": 26}], "rsi": [{"timeperiod": 14}]}'
})3. Advanced Multi-Indicator Analysis
# Complex indicator configuration
indicators_config = {
"ema": [{"timeperiod": 12}, {"timeperiod": 26}, {"timeperiod": 50}],
"macd": [{"fastperiod": 12, "slowperiod": 26, "signalperiod": 9}],
"rsi": [{"timeperiod": 14}, {"timeperiod": 21}],
"bbands": [{"timeperiod": 20, "nbdevup": 2, "nbdevdn": 2}],
"stoch": [{"fastkperiod": 5, "slowkperiod": 3, "slowdperiod": 3}]
}
result = await session.call_tool("get_enhanced_dex_data_with_indicators", {
"chain_index": "1",
"token_address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
"timeframe": "1h",
"limit": 200,
"indicators_config": json.dumps(indicators_config)
})Advanced Usage Patterns
Pattern Recognition Analysis
# Candlestick pattern recognition
pattern_config = {
"cdldoji": [{}],
"cdlhammer": [{}],
"cdlengulfing": [{}],
"cdl3blackcrows": [{}],
"cdlmorningstar": [{}]
}
result = await session.call_tool("get_enhanced_dex_data_with_indicators", {
"chain_index": "1",
"token_address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
"timeframe": "4h",
"limit": 100,
"indicators_config": json.dumps(pattern_config)
})Multi-Timeframe Analysis
# Analyze same asset across different timeframes
timeframes = ["1h", "4h", "1d"]
results = {}
for tf in timeframes:
result = await session.call_tool("get_enhanced_dex_data_with_indicators", {
"chain_index": "1",
"token_address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
"timeframe": tf,
"limit": 50,
"indicators_config": '{"ema": [{"timeperiod": 20}], "rsi": [{"timeperiod": 14}]}'
})
results[tf] = result📚 API Documentation
Available Tools
Tool Name | Description | Transport Support |
| Advanced DEX data with flexible indicators | stdio, HTTP/SSE |
| Complete indicator registry | stdio, HTTP/SSE |
| CEX data with enhanced indicators | stdio, HTTP/SSE |
| DEX data with indicators (legacy) | stdio, HTTP/SSE |
| Current DEX token price | stdio, HTTP/SSE |
| Current CEX price | stdio, HTTP/SSE |
Tool Specifications
get_enhanced_dex_data_with_indicators
Purpose: Fetch DEX candlestick data with comprehensive technical indicators
Parameters:
chain_index(string, required): Blockchain identifier ("1" for Ethereum, "56" for BSC, etc.)token_address(string, required): Token contract address (42-character hex string)timeframe(string, optional): Time interval ("1m", "5m", "15m", "1h", "4h", "1d", "1w")limit(integer, optional): Number of candles to fetch (default: 100, max: 1000)indicators_config(string, required): JSON string with indicator configurations
Example Request:
{
"chain_index": "1",
"token_address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
"timeframe": "1h",
"limit": 100,
"indicators_config": "{\"ema\": [{\"timeperiod\": 12}, {\"timeperiod\": 26}], \"rsi\": [{\"timeperiod\": 14}]}"
}Response Format:
{
"success": true,
"data": {
"candles": [...],
"indicators": {
"ema_12": [...],
"ema_26": [...],
"rsi_14": [...]
},
"metadata": {
"symbol": "USDC",
"timeframe": "1h",
"count": 100
}
}
}📊 Supported Indicators
Indicator Categories (158 Total)
Category | Count | Examples |
Momentum Indicators | 30 | RSI, MACD, Stochastic, ADX, CCI, Williams %R, ROC |
Overlap Studies | 17 | SMA, EMA, Bollinger Bands, KAMA, T3, TEMA |
Pattern Recognition | 61 | Doji, Hammer, Engulfing, Three Black Crows, Morning Star |
Volume Indicators | 3 | OBV, A/D Line, Chaikin A/D Oscillator |
Volatility Indicators | 3 | ATR, NATR, True Range |
Price Transform | 4 | Average Price, Median Price, Typical Price, Weighted Close |
Cycle Indicators | 5 | Hilbert Transform Dominant Cycle Period, Trend Mode |
Statistic Functions | 9 | Beta, Correlation, Linear Regression, Standard Deviation |
Math Transform | 15 | ACOS, ASIN, ATAN, COS, SIN, TAN, SQRT, LN, LOG10 |
Math Operators | 11 | ADD, SUB, MULT, DIV, MIN, MAX, SUM |
Parameter Format Examples
Basic Indicators
{
"sma": [{"timeperiod": 20}],
"ema": [{"timeperiod": 12}, {"timeperiod": 26}],
"rsi": [{"timeperiod": 14}]
}Advanced Indicators
{
"macd": [{"fastperiod": 12, "slowperiod": 26, "signalperiod": 9}],
"bbands": [{"timeperiod": 20, "nbdevup": 2, "nbdevdn": 2}],
"stoch": [{"fastkperiod": 5, "slowkperiod": 3, "slowdperiod": 3}]
}Pattern Recognition
{
"cdldoji": [{}],
"cdlhammer": [{}],
"cdlengulfing": [{}]
}Result Column Naming
The service automatically generates descriptive column names based on parameters:
Single Parameter:
indicator_value(e.g.,rsi_14,sma_20)Multiple Parameters:
indicator_param1_param2_...(e.g.,macd_12_26_9)Multiple Outputs:
indicator_params_output(e.g.,bbands_2_2_20_upperband)
Popular Indicator Combinations
Trend Following Strategy
{
"ema": [{"timeperiod": 12}, {"timeperiod": 26}, {"timeperiod": 50}],
"macd": [{"fastperiod": 12, "slowperiod": 26, "signalperiod": 9}],
"adx": [{"timeperiod": 14}]
}Mean Reversion Strategy
{
"rsi": [{"timeperiod": 14}],
"bbands": [{"timeperiod": 20, "nbdevup": 2, "nbdevdn": 2}],
"stoch": [{"fastkperiod": 5, "slowkperiod": 3, "slowdperiod": 3}]
}Momentum Analysis
{
"rsi": [{"timeperiod": 14}, {"timeperiod": 21}],
"cci": [{"timeperiod": 14}],
"willr": [{"timeperiod": 14}],
"roc": [{"timeperiod": 10}]
}🌐 Data Sources
Centralized Exchanges (CEX)
Supported via CCXT Library (100+ exchanges):
Major Exchanges
Binance - World's largest cryptocurrency exchange
Coinbase - Leading US-based exchange
Kraken - Established European exchange
Bitfinex - Advanced trading features
Huobi - Global cryptocurrency exchange
OKX - Comprehensive trading platform
Regional Exchanges
Bitstamp - European exchange
Gemini - Regulated US exchange
KuCoin - Global altcoin exchange
Gate.io - Wide variety of trading pairs
Bybit - Derivatives trading platform
Decentralized Exchanges (DEX)
Supported via OKX DEX API:
Supported Blockchains
Chain | Chain Index | Native Token | Popular DEXs |
Ethereum | 1 | ETH | Uniswap, SushiSwap, 1inch |
BSC | 56 | BNB | PancakeSwap, Venus |
Polygon | 137 | MATIC | QuickSwap, SushiSwap |
Avalanche | 43114 | AVAX | Trader Joe, Pangolin |
Arbitrum | 42161 | ETH | Uniswap V3, SushiSwap |
Optimism | 10 | ETH | Uniswap V3, Synthetix |
Popular Token Addresses
Ethereum (chain_index: "1"):
USDC: 0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48
USDT: 0xdac17f958d2ee523a2206206994597c13d831ec7
WETH: 0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2
DAI: 0x6b175474e89094c44da98b954eedeac495271d0fBSC (chain_index: "56"):
WBNB: 0xbb4cdb9cbd36b01bd1cbaebf2de08d9173bc095c
BUSD: 0xe9e7cea3dedca5984780bafc599bd69add087d56
CAKE: 0x0e09fabb73bd3ade0a17ecc321fd13a19e81ce82🛠️ Development
Project Structure
crypto-powerdata-mcp/
├── src/
│ ├── main.py # Main MCP server entry point
│ ├── data_provider.py # Data fetching and processing
│ ├── enhanced_indicators.py # Advanced technical analysis
│ ├── talib_registry.py # TA-Lib indicator registry
│ ├── mcp_bridge.py # Transport protocol bridge
│ └── dual_transport_server.py # HTTP/SSE server
├── tests/
│ ├── test_enhanced_mcp.py # Comprehensive test suite
│ ├── test_mcp_functionality.py # Basic functionality tests
│ └── comprehensive_mcp_test.py # Advanced testing
├── docs/
│ ├── API_DOCUMENTATION.md # Detailed API reference
│ ├── CONFIGURATION.md # Configuration guide
│ └── TESTING_REPORT.md # Testing documentation
├── config_examples.py # Configuration examples
├── pyproject.toml # Project dependencies
├── README.md # This file
└── LICENSE # MIT licenseDevelopment Setup
# Clone repository
git clone https://github.com/veithly/crypto-powerdata-mcp.git
cd crypto-powerdata-mcp
# Install development dependencies
uv sync --dev
# Install pre-commit hooks
pre-commit install
# Run tests
pytest
# Run linting
black src/ tests/
isort src/ tests/
flake8 src/ tests/
mypy src/Adding New Indicators
Register in TA-Lib Registry (
src/talib_registry.py):
def register_custom_indicator(self):
self.indicators["custom_indicator"] = IndicatorDefinition(
name="custom_indicator",
category=IndicatorCategory.MOMENTUM,
description="Custom indicator description",
# ... other parameters
)Implement Calculation (
src/enhanced_indicators.py):
def calculate_custom_indicator(self, data, params):
# Implementation here
return resultAdd Tests (
tests/test_enhanced_mcp.py):
def test_custom_indicator():
# Test implementation
pass🧪 Testing
Test Suite Overview
The project includes comprehensive testing to ensure reliability and functionality:
Available Test Files
test_enhanced_mcp.py- Comprehensive test suite for enhanced MCP featuresTests all 158 TA-Lib indicators
Validates multi-parameter support
Checks transport protocols
Error handling scenarios
test_mcp_functionality.py- Basic functionality demonstrationSimple usage examples
Integration testing
Client-server communication
comprehensive_mcp_test.py- Advanced testing scenariosPerformance testing
Edge case handling
Real-world usage patterns
Running Tests
Quick Test
# Run basic functionality test
uv run python test_mcp_functionality.pyComprehensive Testing
# Run all tests with pytest
pytest tests/ -v
# Run specific test file
pytest test_enhanced_mcp.py -v
# Run with coverage
pytest --cov=src --cov-report=htmlManual Testing
# Test enhanced indicators system
uv run python -c "
import asyncio
from src.enhanced_indicators import EnhancedTechnicalAnalysis
import pandas as pd
import numpy as np
async def test():
ta = EnhancedTechnicalAnalysis()
# Create sample data
dates = pd.date_range('2024-01-01', periods=100, freq='1H')
data = pd.DataFrame({
'open': np.random.uniform(50000, 51000, 100),
'high': np.random.uniform(50500, 51500, 100),
'low': np.random.uniform(49500, 50500, 100),
'close': np.random.uniform(50000, 51000, 100),
'volume': np.random.uniform(100, 1000, 100)
}, index=dates)
# Test indicators
config = {
'ema': [{'timeperiod': 12}, {'timeperiod': 26}],
'rsi': [{'timeperiod': 14}],
'macd': [{'fastperiod': 12, 'slowperiod': 26, 'signalperiod': 9}]
}
result = ta.calculate_indicators(data, config)
print(f'✅ Calculated {len(result.columns)} columns')
print(f'📊 Indicators: {[col for col in result.columns if col not in data.columns]}')
asyncio.run(test())
"Performance Testing
# Test HTTP transport performance
curl -X POST http://localhost:8000/mcp \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"method": "initialize",
"params": {"protocolVersion": "2024-11-05"},
"id": 1
}'Troubleshooting Tests
Common Issues
Import Errors
# Solution: Set PYTHONPATH export PYTHONPATH=/path/to/crypto-powerdata-mcpTA-Lib Installation Issues
# Windows conda install -c conda-forge ta-lib # macOS brew install ta-lib pip install ta-lib # Linux sudo apt-get install libta-lib-dev pip install ta-libAPI Rate Limits
# Solution: Reduce request rate export RATE_LIMIT_REQUESTS_PER_SECOND=5Memory Issues
# Solution: Use smaller datasets # Reduce limit parameter in API calls
Debug Mode
# Enable detailed logging
export LOG_LEVEL=DEBUG
uv run python -m src.main🤝 Contributing
We welcome contributions to the Crypto PowerData MCP service! Here's how you can help:
Ways to Contribute
Bug Reports - Report issues via GitHub Issues
Feature Requests - Suggest new features or improvements
Code Contributions - Submit pull requests for bug fixes or new features
Documentation - Improve documentation and examples
Testing - Add test cases or improve existing tests
Development Workflow
Fork the Repository
git clone https://github.com/veithly/crypto-powerdata-mcp.git cd crypto-powerdata-mcpCreate a Feature Branch
git checkout -b feature/your-feature-nameSet Up Development Environment
uv sync --dev pre-commit installMake Your Changes
Follow the existing code style
Add tests for new features
Update documentation as needed
Run Tests
pytest tests/ -v black src/ tests/ isort src/ tests/ flake8 src/ tests/ mypy src/Commit and Push
git add . git commit -m "feat: add your feature description" git push origin feature/your-feature-nameCreate Pull Request
Provide clear description of changes
Reference any related issues
Ensure all tests pass
Code Style Guidelines
Python Style: Follow PEP 8 with Black formatting
Type Hints: Use type hints for all function parameters and returns
Documentation: Add docstrings for all public functions and classes
Testing: Maintain test coverage above 80%
Adding New Features
Adding Exchange Support
Extend
data_provider.pywith new exchange integrationAdd configuration options in
main.pyCreate comprehensive tests
Update documentation
Adding New Indicators
Register in
talib_registry.pyImplement calculation in
enhanced_indicators.pyAdd parameter validation
Create test cases
Update API documentation
Reporting Issues
When reporting bugs, please include:
Python version and operating system
Complete error messages and stack traces
Steps to reproduce the issue
Expected vs actual behavior
Relevant configuration details
Feature Requests
For feature requests, please provide:
Clear description of the proposed feature
Use cases and benefits
Potential implementation approach
Any relevant examples or references
📄 License
This project is licensed under the MIT License - see the LICENSE file for details.
MIT License Summary
✅ Commercial Use - Use in commercial projects
✅ Modification - Modify the source code
✅ Distribution - Distribute the software
✅ Private Use - Use for private projects
❌ Liability - No warranty or liability
❌ Warranty - No warranty provided
Third-Party Licenses
This project uses several open-source libraries:
TA-Lib - BSD License
CCXT - MIT License
FastAPI - MIT License
Pandas - BSD License
NumPy - BSD License
🙏 Acknowledgments
Special thanks to the following projects and communities:
TA-Lib - Technical Analysis Library for comprehensive indicator calculations
CCXT - Cryptocurrency Exchange Trading Library for multi-exchange support
OKX - DEX API provider for decentralized exchange data
FastMCP - Model Context Protocol framework
FastAPI - Modern web framework for HTTP transport
Model Context Protocol - Protocol specification and community
Contributors
Initial development and architecture
Technical analysis system design
Dual transport protocol implementation
Comprehensive testing framework
Documentation and examples
📞 Support
Documentation: API Documentation | Configuration Guide
Issues: GitHub Issues
Discussions: GitHub Discussions
Email: dev@example.com
Made with ❤️ for the cryptocurrency and AI communities
This server cannot be deployed
Maintenance
Related MCP Connectors
Real-time crypto market data: candles, tickers, orderbooks across 13+ exchanges via MCP.
Crypto trading intelligence MCP — 34+ endpoints, x402 pay-per-use, AI agent strategy & execution
MCP server with quote and live cryptocurrency price tools, local and cloud-deployed transports.
Trade 16 crypto exchanges + MetaTrader 5 from your AI assistant via one MCP connection.
Related MCP Servers
- AlicenseBqualityDmaintenanceHigh-performance CCXT MCP server for cryptocurrency exchange integration2466 npm144MIT
- AlicenseAqualityDmaintenanceA comprehensive cryptocurrency market-data MCP server with 49 tools across six data sources, enabling LLMs to answer market questions via natural language.49MIT
- FlicenseNot gradedqualityDmaintenancePython-based MCP server that provides real-time and historical cryptocurrency data from 100+ exchanges via CCXT, with tools for tickers, OHLCV, markets, and order books.1-
- AlicenseDqualityDmaintenanceA powerful cryptocurrency analysis MCP server that adds advanced technical analysis capabilities to the original Binance MCP implementation.151Apache 2.0