Crypto Indicators MCP Server

1# Crypto Indicators MCP Server
2 
3An MCP server providing a range of cryptocurrency technical analysis indicators and strategies, empowering AI trading agents to efficiently analyze market trends and develop robust quantitative strategies.
4 
5For more crypto-related MCP servers, see the [Kukapay MCP servers](https://github.com/kukapay/kukapay-mcp-servers).
6 
7[![License](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
8[![Node.js](https://img.shields.io/badge/Node.js-18.x-green.svg)](https://nodejs.org/)
9![Status](https://img.shields.io/badge/status-active-brightgreen.svg)
10 
11## Features
12 
13- **Technical Indicators**: 50+ indicators across trend, momentum, volatility, and volume categories.
14- **Trading Strategies**: Corresponding strategies outputting signals: `-1` (SELL), `0` (HOLD), `1` (BUY).
15- **Flexible Data Source**: Defaults to Binance, configurable to any `ccxt`-supported exchange.
16- **Modular Design**: Indicators and strategies are categorized for easy maintenance.
17 
18## Installation
19 
20### Prerequisites
21 
22- [Node.js](https://nodejs.org/) (v18.x or higher)
23- npm (v8.x or higher)
24 
25### Steps
26 
271. **Clone the Repository**:
28   ```bash
29   git clone https://github.com/kukapay/crypto-indicators-mcp.git
30   cd crypto-indicators-mcp
31   ```
32 
332. **Install Dependencies**:
34   ```bash
35   npm install
36   ```
37 
383. **Configure MCP Client**:
39   To use this server with an MCP client like Claude Desktop, add the following to your config file (or equivalent):
40   ```json
41    {
42      "mcpServers": {
43        "crypto-indicators-mcp": {
44          "command": "node",
45          "args": ["path/to/crypto-indicators-mcp/index.js"],
46          "env": {
47            "EXCHANGE_NAME": "binance"
48          }
49        }
50      }
51    }   
52    ```
53 
54## Available Tools
55 
56### Trend Indicators
57- `calculate_absolute_price_oscillator`: Measures the difference between two EMAs to identify trend strength (APO).
58- `calculate_aroon`: Identifies trend changes and strength using high/low price extremes (Aroon).
59- `calculate_balance_of_power`: Gauges buying vs. selling pressure based on price movement (BOP).
60- `calculate_chande_forecast_oscillator`: Predicts future price movements relative to past trends (CFO).
61- `calculate_commodity_channel_index`: Detects overbought/oversold conditions and trend reversals (CCI).
62- `calculate_double_exponential_moving_average`: Smooths price data with reduced lag for trend detection (DEMA).
63- `calculate_exponential_moving_average`: Weights recent prices more heavily for trend analysis (EMA).
64- `calculate_mass_index`: Identifies potential reversals by measuring range expansion (MI).
65- `calculate_moving_average_convergence_divergence`: Tracks momentum and trend direction via EMA differences (MACD).
66- `calculate_moving_max`: Computes the maximum price over a rolling period (MMAX).
67- `calculate_moving_min`: Computes the minimum price over a rolling period (MMIN).
68- `calculate_moving_sum`: Calculates the sum of prices over a rolling period (MSUM).
69- `calculate_parabolic_sar`: Provides stop-and-reverse points for trend following (PSAR).
70- `calculate_qstick`: Measures buying/selling pressure based on open-close differences (Qstick).
71- `calculate_kdj`: Combines stochastic and momentum signals for trend analysis (KDJ).
72- `calculate_rolling_moving_average`: Applies a rolling EMA for smoother trend tracking (RMA).
73- `calculate_simple_moving_average`: Averages prices over a period to identify trends (SMA).
74- `calculate_since_change`: Tracks the time since the last significant price change.
75- `calculate_triple_exponential_moving_average`: Reduces lag further than DEMA for trend clarity (TEMA).
76- `calculate_triangular_moving_average`: Weights middle prices more for smoother trends (TRIMA).
77- `calculate_triple_exponential_average`: Measures momentum with triple smoothing (TRIX).
78- `calculate_typical_price`: Averages high, low, and close prices for a balanced trend view.
79- `calculate_volume_weighted_moving_average`: Incorporates volume into moving averages for trend strength (VWMA).
80- `calculate_vortex`: Identifies trend direction and strength using true range (Vortex).
81 
82### Momentum Indicators
83- `calculate_awesome_oscillator`: Measures market momentum using midline crossovers (AO).
84- `calculate_chaikin_oscillator`: Tracks accumulation/distribution momentum (CMO).
85- `calculate_ichimoku_cloud`: Provides a comprehensive view of support, resistance, and momentum (Ichimoku).
86- `calculate_percentage_price_oscillator`: Normalizes MACD as a percentage for momentum (PPO).
87- `calculate_percentage_volume_oscillator`: Measures volume momentum via EMA differences (PVO).
88- `calculate_price_rate_of_change`: Tracks price momentum as a percentage change (ROC).
89- `calculate_relative_strength_index`: Identifies overbought/oversold conditions via momentum (RSI).
90- `calculate_stochastic_oscillator`: Compares closing prices to ranges for momentum signals (STOCH).
91- `calculate_williams_r`: Measures momentum relative to recent high-low ranges (Williams %R).
92 
93### Volatility Indicators
94- `calculate_acceleration_bands`: Frames price action with dynamic volatility bands (AB).
95- `calculate_average_true_range`: Measures market volatility based on price ranges (ATR).
96- `calculate_bollinger_bands`: Encloses price action with volatility-based bands (BB).
97- `calculate_bollinger_bands_width`: Quantifies volatility via band width changes (BBW).
98- `calculate_chandelier_exit`: Sets trailing stop-losses based on volatility (CE).
99- `calculate_donchian_channel`: Tracks volatility with high/low price channels (DC).
100- `calculate_keltner_channel`: Combines ATR and EMA for volatility bands (KC).
101- `calculate_moving_standard_deviation`: Measures price deviation for volatility (MSTD).
102- `calculate_projection_oscillator`: Assesses volatility relative to projected prices (PO).
103- `calculate_true_range`: Calculates daily price range for volatility analysis (TR).
104- `calculate_ulcer_index`: Quantifies downside volatility and drawdowns (UI).
105 
106### Volume Indicators
107- `calculate_accumulation_distribution`: Tracks volume flow to confirm price trends (AD).
108- `calculate_chaikin_money_flow`: Measures buying/selling pressure with volume (CMF).
109- `calculate_ease_of_movement`: Assesses how easily prices move with volume (EMV).
110- `calculate_force_index`: Combines price and volume for momentum strength (FI).
111- `calculate_money_flow_index`: Identifies overbought/oversold via price-volume (MFI).
112- `calculate_negative_volume_index`: Tracks price changes on lower volume days (NVI).
113- `calculate_on_balance_volume`: Accumulates volume to predict price movements (OBV).
114- `calculate_volume_price_trend`: Combines volume and price for trend confirmation (VPT).
115- `calculate_volume_weighted_average_price`: Averages prices weighted by volume (VWAP).
116 
117### Trend Strategies
118- `calculate_absolute_price_oscillator_strategy`: Generates buy/sell signals from APO crossovers (APO Strategy).
119- `calculate_aroon_strategy`: Signals trend reversals using Aroon crossovers (Aroon Strategy).
120- `calculate_balance_of_power_strategy`: Issues signals based on BOP thresholds (BOP Strategy).
121- `calculate_chande_forecast_oscillator_strategy`: Predicts reversals with CFO signals (CFO Strategy).
122- `calculate_kdj_strategy`: Combines KDJ lines for trend-based signals (KDJ Strategy).
123- `calculate_macd_strategy`: Uses MACD crossovers for trading signals (MACD Strategy).
124- `calculate_parabolic_sar_strategy`: Signals trend direction with PSAR shifts (PSAR Strategy).
125- `calculate_typical_price_strategy`: Generates signals from typical price trends.
126- `calculate_volume_weighted_moving_average_strategy`: Issues signals based on VWMA crossovers (VWMA Strategy).
127- `calculate_vortex_strategy`: Signals trend direction with Vortex crossovers (Vortex Strategy).
128 
129### Momentum Strategies
130- `calculate_momentum_strategy`: Issues signals based on momentum direction.
131- `calculate_awesome_oscillator_strategy`: Signals momentum shifts with AO crossovers (AO Strategy).
132- `calculate_ichimoku_cloud_strategy`: Generates signals from Ichimoku cloud positions (Ichimoku Strategy).
133- `calculate_rsi2_strategy`: Signals overbought/oversold with RSI thresholds (RSI Strategy).
134- `calculate_stochastic_oscillator_strategy`: Uses stochastic crossovers for signals (STOCH Strategy).
135- `calculate_williams_r_strategy`: Signals momentum reversals with Williams %R (Williams %R Strategy).
136 
137### Volatility Strategies
138- `calculate_acceleration_bands_strategy`: Signals breakouts with acceleration bands (AB Strategy).
139- `calculate_bollinger_bands_strategy`: Issues signals from Bollinger Band breaches (BB Strategy).
140- `calculate_projection_oscillator_strategy`: Signals volatility shifts with PO (PO Strategy).
141 
142### Volume Strategies
143- `calculate_chaikin_money_flow_strategy`: Signals volume pressure with CMF (CMF Strategy).
144- `calculate_ease_of_movement_strategy`: Issues signals based on EMV trends (EMV Strategy).
145- `calculate_force_index_strategy`: Signals momentum with force index shifts (FI Strategy).
146- `calculate_money_flow_index_strategy`: Signals overbought/oversold with MFI (MFI Strategy).
147- `calculate_negative_volume_index_strategy`: Signals trends with NVI changes (NVI Strategy).
148- `calculate_volume_weighted_average_price_strategy`: Issues signals from VWAP crossovers (VWAP Strategy).
149 
150## Usage Examples
151 
152### Example 1: Calculate MACD Indicator
153 
154**Input (Natural Language Prompt)**:
155```
156Calculate the MACD for BTC/USDT on a 1-hour timeframe with fast period 12, slow period 26, signal period 9, and fetch 100 data points.
157```
158 
159**Output**:
160```
161{"macd": [...], "signal": [...], "histogram": [...]}
162```
163 
164### Example 2: Calculate RSI Strategy
165 
166**Input (Natural Language Prompt)**:
167```
168Give me the RSI strategy signals for ETH/USDT on a 4-hour timeframe with a period of 14 and 50 data points.
169```
170 
171**Output**:
172```
173[-1, 0, 1, 0, ...]
174```
175 
176## License
177 
178This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
179 
180