crypto-feargreed-mcp

The Crypto Fear & Greed Index MCP Server provides real-time and historical data on the Crypto Fear & Greed Index, powered by Alternative.me. It allows easy integration into MCP-compatible clients, offering features like retrieving the latest index value, fetching historical data, and performing trend analysis.

GitHub Stars

40

User Rating

Not Rated

Favorites

0

Views

25

Forks

14

Issues

4

Installation
Difficulty
Intermediate
Estimated Time
10-20 minutes
Requirements
Python 3.10以上

Installation

Installation

Prerequisites

Please specify required software and versions:
Node.js: 18.0.0 or higher
npm: 8.0.0 or higher
Claude Desktop: Latest version

Installation Steps

1. Clone Repository

bash
git clone https://github.com/kukapay/crypto-feargreed-mcp.git
cd crypto-feargreed-mcp

2. Install for Claude Desktop

bash
mcp install main.py --name "CryptoFearGreed"

3. Configure for Other Clients

Edit claude_desktop_config.json to add the MCP server:
json
{
  "mcpServers": { 
    "crypto-feargreed-mcp": { 
      "command": "uv", 
      "args": [ 
        "--directory", "/your/path/to/crypto-feargreed-mcp", 
        "run", 
        "main.py" 
      ] 
    } 
  }
}

Troubleshooting

Common Issues

Issue: Server won't start Solution: Check Node.js version and reinstall dependencies. Issue: Not recognized by Claude Desktop Solution: Verify configuration file path and syntax.

Configuration

Configuration

Basic Configuration

Claude Desktop Setup

Edit ~/.config/claude-desktop/claude_desktop_config.json (macOS/Linux) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
json
{
  "mcpServers": {
    "crypto-feargreed-mcp": {
      "command": "uv",
      "args": [
        "--directory", "/your/path/to/crypto-feargreed-mcp",
        "run",
        "main.py"
      ]
    }
  }
}

Environment Variables

Set the following environment variables as needed:
bash
export API_KEY="your-api-key"
export DEBUG="true"

Advanced Configuration

Security Settings

Store API keys in environment variables or secure configuration files
Set appropriate file access permissions
Adjust logging levels

Performance Tuning

Configure timeout values
Limit concurrent executions
Set up caching

Configuration Examples

Basic Configuration

json
{
  "mcpServers": {
    "crypto-feargreed-mcp": {
      "command": "uv",
      "args": [
        "--directory", "/your/path/to/crypto-feargreed-mcp",
        "run",
        "main.py"
      ]
    }
  }
}

Examples

Examples

Basic Usage

Here are basic usage examples for the MCP server:

Using with Claude Desktop

1Verify MCP Server Startup
Open Claude Desktop and confirm that the configuration has been loaded correctly.
2Execute Basic Commands

   Available tools from this MCP server:
   - get_current_fng_tool: Retrieve the latest Fear & Greed Index value and classification.
   - get_historical_fng_tool: Fetch historical index values for a specified number of days.
   

Programmatic Usage

python

Python example

import requests def call_mcp_tool(tool_name, params): response = requests.post( 'http://localhost:3000/mcp/call', json={ 'tool': tool_name, 'parameters': params } ) return response.json()

Usage example

result = call_mcp_tool('get_current_fng_tool', {}) print(result)

Use Cases

Retrieve the current Crypto Fear & Greed Index for investment decision-making.
Fetch historical index data for the past 30 days to analyze trends.
Interpret specific index values to evaluate their impact on the cryptocurrency market.
Create automation scripts in MCP clients to regularly fetch data.

Additional Resources