Is Crypto Powerdata Mcp safe to install?

SaferSkills independently audited Crypto Powerdata Mcp (Agent Skill) and scored it 100/100 (green). The audit ran 55 deterministic rules across Security, Supply Chain, Maintenance, Transparency, and Community; it found 0 high-severity and 0 lower-severity findings. The full rule-by-rule trace and per-finding evidence are below. Free, methodology-open.

CategoryWeightCategory scoreContribution

Securityprompt, exec, net, exfil, eval

35%

100

35.0 pts

Supply chainhash, typosquat, maintainer, lockfile

20%

100

20.0 pts

Maintenancestaleness, pinning, CI

15%

100

15.0 pts

TransparencySKILL.md, perms, README

15%

100

15.0 pts

Communityinstalls, verify, response

15%

100

15.0 pts

Findings & checks · 0 flagged

Securityscore 100 · 0 findings

✓—All security checks passedNo findings in this category for the latest scan.pass

Supply chainscore 100 · 0 findings

✓—All supply chain checks passedNo findings in this category for the latest scan.pass

Maintenancescore 100 · 0 findings

✓—All maintenance checks passedNo findings in this category for the latest scan.pass

Transparencyscore 100 · 0 findings

✓—All transparency checks passedNo findings in this category for the latest scan.pass

Communityscore 100 · 0 findings

✓—All community checks passedNo findings in this category for the latest scan.pass

The primary manifest — the file an agent reads to learn what this artifact does.

README.md · 1 file

README.md28.6 KB · Markdown

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_secret

Claude 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](QUICK_START.md)

🎯 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.py

#### Option 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 auto

3. 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 implementation
CCXT: ccxt>=4.0.0 - Cryptocurrency exchange trading library
TA-Lib: ta-lib>=0.4.25 - Technical analysis library
FastAPI: fastapi>=0.104.0 - Modern web framework for HTTP transport
Pandas: pandas>=2.0.0 - Data manipulation and analysis
NumPy: 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_secret

Advantages:

✅ 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 sync

#### Method 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 dependencies

TA-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-Lib

#### macOS

brew install ta-lib
pip install TA-Lib

#### Linux (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=8000

OKX 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
`get_enhanced_dex_data_with_indicators`	Advanced DEX data with flexible indicators	stdio, HTTP/SSE
`get_available_indicators`	Complete indicator registry	stdio, HTTP/SSE
`get_cex_data_with_indicators`	CEX data with enhanced indicators	stdio, HTTP/SSE
`get_dex_data_with_indicators`	DEX data with indicators (legacy)	stdio, HTTP/SSE
`get_dex_token_price`	Current DEX token price	stdio, HTTP/SSE
`get_cex_price`	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:  0x6b175474e89094c44da98b954eedeac495271d0f

BSC (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 license

Development 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 result

Add 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 features

Tests all 158 TA-Lib indicators
Validates multi-parameter support
Checks transport protocols
Error handling scenarios

`test_mcp_functionality.py` - Basic functionality demonstration

Simple usage examples
Integration testing
Client-server communication

`comprehensive_mcp_test.py` - Advanced testing scenarios

Performance testing
Edge case handling
Real-world usage patterns

Running Tests

#### Quick Test

# Run basic functionality test
uv run python test_mcp_functionality.py

#### Comprehensive 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=html

#### Manual 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-mcp

TA-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-lib

API Rate Limits

   # Solution: Reduce request rate
   export RATE_LIMIT_REQUESTS_PER_SECOND=5

Memory 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-mcp

Create a Feature Branch

   git checkout -b feature/your-feature-name

Set Up Development Environment

   uv sync --dev
   pre-commit install

Make 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-name

Create 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.py with new exchange integration
Add configuration options in main.py
Create comprehensive tests
Update documentation

#### Adding New Indicators

Register in talib_registry.py
Implement calculation in enhanced_indicators.py
Add 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](https://ta-lib.org/) - Technical Analysis Library for comprehensive indicator calculations
[CCXT](https://github.com/ccxt/ccxt) - Cryptocurrency Exchange Trading Library for multi-exchange support
[OKX](https://www.okx.com/) - DEX API provider for decentralized exchange data
[FastMCP](https://github.com/jlowin/fastmcp) - Model Context Protocol framework
[FastAPI](https://fastapi.tiangolo.com/) - Modern web framework for HTTP transport
[Model Context Protocol](https://modelcontextprotocol.io/) - 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: [email protected]

Made with ❤️ for the cryptocurrency and AI communities

Is Crypto Powerdata Mcp safe to install?

Crypto PowerData MCP Service

🚀 Quick Start with uvx (Recommended)

📋 Table of Contents

🎯 Overview

Key Capabilities

✨ Features

🔄 Dual Transport Architecture

📊 Comprehensive Technical Analysis

🌐 Multi-Exchange Support

🛡️ Robust Parameter Handling

🏗️ Architecture

Core Components

🚀 Quick Start

Prerequisites

1. Installation

2. Basic Usage

3. First API Call

📦 Installation

System Requirements

Dependencies

Installation Methods

TA-Lib Installation

⚙️ Configuration

Environment Variables

OKX API Setup

MCP Client Configuration

💡 Usage Examples

Basic Examples

Advanced Usage Patterns

📚 API Documentation

Available Tools

Tool Specifications

📊 Supported Indicators

Indicator Categories (158 Total)

Parameter Format Examples

Result Column Naming

Popular Indicator Combinations

🌐 Data Sources

Centralized Exchanges (CEX)

Decentralized Exchanges (DEX)

🛠️ Development

Project Structure

Development Setup

Adding New Indicators

🧪 Testing

Test Suite Overview

Running Tests

Performance Testing

Troubleshooting Tests

Debug Mode

🤝 Contributing

Ways to Contribute

Development Workflow

Code Style Guidelines

Adding New Features

Reporting Issues

Feature Requests

📄 License

MIT License Summary

Third-Party Licenses

🙏 Acknowledgments

Contributors

📞 Support

Audit the pieces. Scan the whole. Decide.