convez.ai
MCP ServerFinanceiroIntermediário
SaintDoresh

Crypto Trader MCP para Claude Desktop

SaintDoresh/Crypto-Trader-MCP-ClaudeDesktop

Dados de criptomoedas em tempo real para Claude Desktop

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP que integra dados de mercado de criptomoedas via CoinGecko diretamente no Claude Desktop. Fornece preços em tempo real, dados históricos, pesquisa de ativos e estatísticas globais do mercado cripto.

Instalação

$npx convez-ai SaintDoresh/Crypto-Trader-MCP-ClaudeDesktop

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
21
Forks
9
Acompanhando
2
Saúde
42%
Último commit
há 1 ano
Versão
—
Issues abertas
1
Contribuidores
1

Casos de uso

  • Análise de preços e tendências de criptomoedas em conversas com Claude
  • Pesquisa de ativos cripto e acompanhamento de moedas em alta
  • Integração de dados de mercado em estratégias de trading

Veredito

MCP bem estruturado com cobertura sólida de funcionalidades cripto via CoinGecko. Setup direto para Claude Desktop, mas requer manutenção do servidor local rodando — adequado para traders e analistas que já trabalham com Python.

README

A tradução para o português deste README ainda está na fila.

Crypto Trader MCP Tool for Claude Desktop

An MCP (Model Context Protocol) tool that provides cryptocurrency market data using the CoinGecko API, specifically designed for Claude Desktop.

Tutorial

For a detailed guide on setting up and using this tool, check out our Medium tutorial: Tutorial: Using Claude Desktop with Crypto Trader MCP Tool to Get Real-Time Cryptocurrency Data

Features

  • Real-time cryptocurrency price data
  • Detailed market information for cryptocurrencies
  • Historical price charts
  • Cryptocurrency search functionality
  • Trending cryptocurrencies tracking
  • Global market statistics

Setup

  1. Ensure you have Python 3.10 or higher installed

  2. Install dependencies:

pip install -r requirements.txt

Integration with Claude Desktop

  1. Configure your MCP settings in Claude Desktop by adding the following to your MCP configuration:
{
  "mcpServers": {
    "crypto-trader": {
      "command": "py",
      "args": ["-3.13", "C:\\Path\\To\\Your\\Crypto-Trader-MCP-ClaudeDesktop\\main.py"]
    }
  }
}
  1. Replace the path with the full path to your main.py file
  2. Run the server using:
py -3.13 main.py
  1. Keep the server running while using Claude Desktop

Available Tools

1. get_crypto_price

Get real-time cryptocurrency price information:

{
    "symbol": "BTC",
    "name": "bitcoin",
    "price": 65423.12,
    "change_24h": 2.5,
    "volume_24h": 28345678901,
    "market_cap": 1234567890123,
    "timestamp": "2025-03-15T10:30:00"
}

2. get_crypto_market_data

Get detailed market information for a cryptocurrency:

{
    "symbol": "ETH",
    "name": "Ethereum",
    "market_cap_rank": 2,
    "current_price": 3521.48,
    "market_cap": 423456789012,
    "total_volume": 15834567890,
    "high_24h": 3580.25,
    "low_24h": 3475.62,
    "price_change_24h": 45.86,
    "price_change_percentage_24h": 1.32,
    "circulating_supply": 120283456,
    "total_supply": 120283456,
    "max_supply": null,
    "ath": 4878.26,
    "ath_date": "2021-11-10T14:24:11.849Z",
    "atl": 0.432979,
    "atl_date": "2015-10-20T00:00:00.000Z"
}

3. get_crypto_historical_data

Get historical price data for a cryptocurrency:

{
    "symbol": "BTC",
    "name": "bitcoin",
    "days": 30,
    "prices": [
        {
            "date": "2025-02-15T00:00:00",
            "price": 62150.23
        },
        {
            "date": "2025-02-16T00:00:00",
            "price": 63421.15
        }
        // ... more data points
    ]
}

4. search_crypto

Search for cryptocurrencies:

{
    "results": [
        {
            "id": "bitcoin",
            "symbol": "BTC",
            "name": "Bitcoin"
        },
        {
            "id": "bitcoin-cash",
            "symbol": "BCH",
            "name": "Bitcoin Cash"
        }
        // ... more results
    ]
}

5. get_trending_crypto

Get trending cryptocurrencies:

{
    "trending_coins": [
        {
            "id": "pendle",
            "name": "Pendle",
            "symbol": "PENDLE",
            "market_cap_rank": 85,
            "price_btc": 0.00002356
        }
        // ... more trending coins
    ]
}

6. get_global_crypto_data

Get global cryptocurrency market data:

{
    "active_cryptocurrencies": 12875,
    "markets": 892,
    "total_market_cap_usd": 2347890123456,
    "total_volume_usd": 89723456789,
    "market_cap_percentage": {
        "BTC": 52.4,
        "ETH": 18.2
        // ... more cryptocurrencies
    },
    "updated_at": "2025-03-15T10:30:00"
}

Sample Queries

You can ask Claude Desktop questions like:

  • "What's the current price of Bitcoin?"
  • "Show me detailed market data for Ethereum"
  • "What's the price history of Dogecoin for the last 30 days?"
  • "Search for cryptocurrencies related to 'sol'"
  • "Which cryptocurrencies are trending today?"
  • "What's the total cryptocurrency market capitalization right now?"

Error Handling

All tools include proper error handling and will return an error message if something goes wrong:

{
    "error": "Failed to fetch price for INVALID_SYMBOL"
}

Troubleshooting

If the MCP server is not working in Claude Desktop:

  1. Make sure the server is running - you should see output when you start the script
  2. Verify the path in your settings is correct and absolute
  3. Make sure Python 3.10+ is in your system PATH
  4. Check that all dependencies are installed
  5. Try restarting Claude Desktop
  6. Check logs for any error messages

Rate Limits

This tool uses the free CoinGecko API which has rate limits. Please be aware that very frequent requests may be throttled by the API.

License

MIT License

Ver o original no GitHub

Bom para

Relacionados