TradingViewMCPServer

Production-ready multi-asset trading assistant and Pine Script development server for Claude Desktop

Professional trading assistant supporting Forex, Stocks, and Crypto with 25+ technical indicators, Pine Script v6 development tools, and production-grade reliability.

✨ Features

🎯 Production-Ready (NEW in v3.4.0!)

• 🏥 Health Monitoring: Built-in health check tool with cache statistics and API status
• 🔄 Auto-Retry Logic: Exponential backoff for network failures (3 retries: 2s, 4s, 8s)
• ⚡ LRU Cache: Memory-bounded cache (1000 entries) with automatic eviction
• 🐳 Docker Support: Production-ready containerization with Docker Compose
• 🚀 CI/CD Pipeline: Automated testing across Python 3.10-3.12
• ✅ 100% Test Coverage: 44/44 tests passing

📊 Trading & Market Analysis

• Multi-Asset Support: Forex (22+ pairs), US Stocks, Cryptocurrencies
• 25+ Technical Indicators: Volume Profile, Market Profile, VWAP, Fibonacci, Bollinger Bands, MACD, Moving Averages, ATR, Support/Resistance, Pivot Points, Stochastic, RSI, CCI, Williams %R, ADX, Ichimoku Cloud, and more
• Full Historical Data: Live quotes and historical data for all asset types (Forex, Stocks, Crypto) via Alpha Vantage API
• Smart Caching: 70% reduction in API calls with intelligent caching
• Claude Desktop Integration: Seamless integration with Claude Desktop via MCP

Pine Script Development Tools (NEW in v3.1)

• Pine Script v6 Support: Full support for latest Pine Script v6 with type, enum, and map! ⭐
• Real-time Syntax Validation: Comprehensive syntax and semantic error checking with line-by-line feedback
• Intelligent Autocomplete: Context-aware code completion with function signatures and documentation
• Live Documentation Access: Instant access to Pine Script function documentation with examples (110+ functions)
• Version Detection: Automatic detection of Pine Script version (v1-v6) with compatibility analysis
• Version Conversion: Automatic code conversion between Pine Script versions (v3→v4→v5→v6)
• Code Testing Sandbox: Safe testing environment with validation and performance metrics
• Error Explanations: Detailed error descriptions with causes, solutions, and code examples
• Code Templates: Ready-to-use templates for indicators, strategies, and overlays

🚀 Quick Start

Prerequisites

• Python 3.10+ or Docker
• Claude Desktop
• Alpha Vantage API key (Get free key)

Option 1: Docker (Recommended) 🐳

# 1. Clone repository
git clone https://github.com/lev-corrupted/TradingViewMCPServer.git
cd TradingViewMCPServer

# 2. Create .env file
echo "ALPHA_VANTAGE_API_KEY=your_key_here" > .env

# 3. Run with Docker Compose
docker-compose up -d

# 4. Check server health
docker-compose logs -f

Option 2: Standard Installation

# 1. Clone repository
git clone https://github.com/lev-corrupted/TradingViewMCPServer.git
cd TradingViewMCPServer

# 2. Create virtual environment
python3 -m venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate

# 3. Install dependencies
pip install -e .

# 4. Create .env file
echo "ALPHA_VANTAGE_API_KEY=your_key_here" > .env

4. Configure Claude Desktop:

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "tradingview": {
      "command": "/absolute/path/to/TradingViewMCPServer/.venv/bin/python",
      "args": [
        "/absolute/path/to/TradingViewMCPServer/tradingview_mcp/server.py",
        "stdio"
      ]
    }
  }
}

Replace /absolute/path/to/TradingViewMCPServer with your actual installation path.

5. Restart Claude Desktop

💡 Usage

Health Check (NEW!) 🏥

Monitor server health and performance:

Check server health
What's the cache hit rate?
Show me server statistics

Returns:

• Server version and status
• API key configuration
• Cache statistics (size, hit rate, evictions)
• Total API calls made

Trading & Market Analysis 📊

Ask Claude Desktop natural language questions:

What's the current price of AAPL?
Show me Bollinger Bands for TSLA on 1h timeframe
Calculate Fibonacci levels for BTC
Get MACD for EURUSD with RSI
Show me support and resistance for NVDA
What's the volume profile for SPY?
Give me the Ichimoku Cloud for ETH
Calculate pivot points and CCI for GBPUSD
Analyze AAPL with Williams %R indicator

Pine Script Development

Ask Claude to help with Pine Script code:

Validate this Pine Script code: [paste code]
Convert this v4 code to v5: [paste code]
Show me documentation for ta.macd
Test this indicator on AAPL 1h timeframe: [paste code]
Explain error E101
Detect the version of this Pine Script: [paste code]
Give me a Pine Script strategy template

🛠️ Available Tools

Server Management (NEW in v3.4.0!)

• health_check - Server health and cache statistics

Price & Market Data

• get_price - Get current price for any asset
• get_multiple_prices - Batch price quotes
• list_available_pairs - List forex pairs
• list_supported_assets - List all supported assets

Technical Analysis

• analyze_pair - Comprehensive analysis
• get_trading_recommendation - Trading signals
• calculate_correlation - Pair correlation

Volume & Profile Analysis

• get_volume_profile - Volume at price levels
• get_market_profile - Market profile with TPO and value areas
• get_vwap - Volume Weighted Average Price
• get_volume_nodes - High/low volume nodes
• detect_unfilled_gaps - Price gaps detection

Momentum Indicators (NEW: RSI, CCI, Williams %R)

• get_stochastic - Stochastic oscillator (%K, %D)
• get_rsi - NEW! RSI (Relative Strength Index)
• get_cci - NEW! CCI (Commodity Channel Index)
• get_williams_r - NEW! Williams %R

Trend Indicators

• get_moving_averages - Multiple SMAs/EMAs
• get_macd - MACD indicator
• get_adx - Average Directional Index (trend strength)
• get_ichimoku_cloud - Ichimoku Cloud

Volatility Indicators

• get_bollinger_bands - Bollinger Bands
• get_atr - Average True Range

Support/Resistance

• get_fibonacci_retracement - Fibonacci levels
• get_support_resistance - Auto-detected levels
• get_pivot_points - Daily pivot points

Pine Script Development (NEW)

• validate_pine_script - Real-time syntax validation with detailed error reporting (v1-v6 support)
• get_pine_documentation - Function and topic documentation with examples (110+ functions)
• test_pine_script - Safe sandbox testing with metrics
• explain_pine_error - Detailed error explanations with solutions
• detect_pine_version - Automatic version detection (v1-v6)
• convert_pine_version - Automatic version conversion (supports v6!)
• autocomplete_pine - Intelligent code completion (includes v6 features)
• get_pine_template - Ready-to-use code templates

Supported Assets

Forex

Major pairs, crosses, exotics, and gold (XAUUSD)

Stocks

US equities including AAPL, MSFT, GOOGL, AMZN, TSLA, NVDA, META, and more

Crypto

BTC, ETH, BNB, XRP, ADA, SOL, and other major cryptocurrencies

Configuration

API Rate Limits

Alpha Vantage free tier:

• 25 requests per day
• 5 API calls per minute

For higher limits, upgrade to premium API key.

Timeframes

Supported timeframes: 5m, 15m, 30m, 1h, 4h, 1d

📈 Version History

Version 3.4.0 - Production Ready (Current) 🚀

Major production-grade improvements:

Performance & Reliability

• ✅ LRU Cache: Memory-bounded cache with automatic eviction (1000 entries max)
• ✅ Auto-Retry: Exponential backoff for network failures (3 retries: 2s, 4s, 8s)
• ✅ Health Check: New MCP tool for monitoring and debugging
• ✅ 100% Tests: All 44 tests passing (was 93%)

Developer Experience

• ✅ Docker Support: Production-ready Dockerfile and docker-compose.yml
• ✅ CI/CD Pipeline: Automated testing across Python 3.9-3.12
• ✅ Requirements: Separate runtime and dev dependencies

Bug Fixes

• Fixed version mismatch in pyproject.toml
• Fixed 3 failing tests (ATR, Bollinger Bands, Pine Script v5)
• Verified .env security (not in git)

Test Results: 44/44 passing (100%) | Files Changed: 12 | Lines Added: 661+

See IMPROVEMENTS_v3.4.0.md for full details.

---

Version 3.3.0 - New Indicators

• Added RSI (Relative Strength Index) indicator
• Added CCI (Commodity Channel Index) indicator
• Added Williams %R indicator
• Full historical data support for Stocks and Crypto
• Updated README: 20+ → 25+ indicators

Version 3.1 - Pine Script v6 Support ⭐

Major update with full Pine Script v6 support:

New Features

• Pine Script v6: Full support for the latest Pine Script version
• V6 Data Structures: type (structs), enum, and map collections
• 110+ Function Signatures: Enhanced function database including map.* namespace
• Enhanced Conversion: v3→v4→v5→v6 automatic migration
• 8 Pine Script MCP Tools: Complete development environment
• 3000+ Lines of Pine Script Code: Lexer, parser, validator, and more
• Version Support: Full support for Pine Script v1-v6
• Intelligent Analysis: AST-based parsing and validation
• Context-aware Completion: Namespace-aware autocomplete (ta., math., str., map.)
• Error Database: Detailed explanations for common errors

See PINE_SCRIPT.md for complete Pine Script documentation.

Architecture

• Modular Design: Clear separation between TradingView analysis and Pine Script tools
• Well-Organized Codebase: Logical grouping by functionality
• Unified MCP Server: Single installation, seamless integration

See ARCHITECTURE.md for detailed architecture documentation.

Version 3.0 - Pine Script Integration

Initial Pine Script development tools release:

• 8 comprehensive MCP tools
• Support for Pine Script v1-v5
• Automatic code conversion and validation

Version 2.0 Improvements

This version included major improvements and refactoring:

Architecture

• Modular Structure: Refactored from monolithic 1700-line file to organized modules
  • api/: API client with caching and rate limiting
  • indicators/: Technical indicators organized by type
  • utils/: Utility functions and formatters
  • config.py: Centralized configuration

Performance & Reliability

• Smart Caching: In-memory cache with TTL reduces API calls by ~70%
• Rate Limiting: Automatic rate limit protection prevents API errors
• Improved Error Handling: Standardized error responses with helpful suggestions
• Comprehensive Logging: Debug and track all operations

Code Quality

• Type Hints: Full type annotations throughout
• Better Calculations: Fixed MACD, Stochastic, and ADX formulas
• Constants: All magic numbers extracted to named constants
• Test Suite: pytest-based testing framework included

Development

• Lower Python Requirement: Now works with Python 3.10+ (was 3.13+)
• Development Tools: Added black, mypy, pytest, and other dev dependencies
• Better Documentation: Improved docstrings and code comments

API Improvements

• Universal Asset Detection: Automatically detects Forex, Stocks, or Crypto
• Better Forex Detection: Handles various formats (EUR/USD, EURUSD, etc.)
• Cache Statistics: View cache performance with get_server_stats() tool

Testing

Run the test suite:

# Install development dependencies
pip install -r requirements-dev.txt

# Run all tests
pytest

# Run with coverage
pytest --cov=tradingview_mcp --cov-report=html

# Run specific test file
pytest tests/test_cache.py -v

# Run tests matching pattern
pytest -k "test_cache" -v

Troubleshooting

Claude Desktop Not Connecting

1. Verify config file path is correct
2. Check Python path in config
3. Ensure .env file exists with valid API key
4. Restart Claude Desktop

API Rate Limit Errors

Wait 1 minute between requests or upgrade API key.

Module Import Errors

Ensure virtual environment is activated and dependencies installed:

source .venv/bin/activate
pip install -e .

📁 Repository Structure

TradingViewMCPServer/
├── tradingview_mcp/          # Core Python package
│   ├── server.py            # MCP server implementation
│   ├── config.py            # Configuration management
│   ├── api/                 # Alpha Vantage API client
│   ├── indicators/          # Technical indicators (25+)
│   ├── pine_script/         # Pine Script development tools
│   └── utils/               # Utilities (cache, retry, etc.)
├── tests/                    # Test suite (44/44 passing)
├── docs/                     # Documentation
│   ├── ARCHITECTURE.md      # System architecture
│   ├── CONTRIBUTING.md      # Contribution guidelines
│   ├── PROJECT_SUMMARY.md   # Project overview
│   ├── GITHUB_REPO_INFO.md  # GitHub repo metadata
│   ├── guides/              # Usage guides
│   └── releases/            # Release notes & checklists
├── examples/                 # Example code
│   └── pine-scripts/        # Pine Script examples & templates
├── .github/                  # GitHub Actions CI/CD
├── logs/                     # Application logs
├── README.md                 # This file
├── CHANGELOG.md              # Complete version history
├── pyproject.toml            # Project metadata
├── requirements.txt          # Dependencies
└── Dockerfile                # Docker configuration

Key Directories

• tradingview_mcp/ - Main Python package with all server logic
• tests/ - Comprehensive test suite with 100% coverage
• docs/ - All documentation, guides, and architecture docs
• examples/pine-scripts/ - Pine Script examples, strategies, and templates
• .github/ - CI/CD workflows and issue templates

License

MIT License - see LICENSE file for details

Contributing

We welcome contributions! Please see CONTRIBUTING.md for detailed guidelines.

How to Contribute

• Bug Reports: Use the bug report template
• Feature Requests: Use the feature request template
• Code Contributions: Fork, create a branch, and submit a PR
• Documentation: Improvements to README, code comments, or examples

Contribution Ideas

• New technical indicators (RSI, CCI, Williams %R, etc.)
• Performance optimizations
• Additional asset types or markets
• Better error handling
• Enhanced documentation
• Example use cases

See CONTRIBUTING.md for development setup and coding standards.

Support

For issues or questions:

1. Check the Troubleshooting section
2. Review CONTRIBUTING.md
3. Search existing GitHub Issues
4. Open a new issue with the appropriate template