convez.ai
MCP ServerDados & AnalyticsIntermediário
kukapay

Crypto Sentiment MCP Server

kukapay/crypto-sentiment-mcp

Análise de sentimento cripto em tempo real para agentes de IA

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP que entrega análise de sentimento de criptomoedas para agentes de IA, utilizando dados agregados de mídia social e notícias da plataforma Santiment. Permite rastrear o humor do mercado, detectar tendências emergentes e monitorar picos de volume em discussões sobre ativos digitais.

Instalação

$npx convez-ai kukapay/crypto-sentiment-mcp

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
47
Forks
20
Acompanhando
3
Saúde
42%
Último commit
há 1 ano
Versão
—
Issues abertas
3
Contribuidores
1

Casos de uso

  • Monitorar sentimento de mercado de criptomoedas em tempo real
  • Detectar picos ou quedas significativas no volume social de ativos
  • Identificar palavras-chave trending nas discussões sobre criptomoedas
  • Medir dominância social de um ativo específico no mercado cripto
  • Alimentar modelos de decisão de trading com dados de sentimento social

Veredito

MCP server bem estruturado e prático para quem trabalha com análise de mercado cripto. Integração simples com Santiment e ferramentas úteis, mas requer API key paga para dados históricos mais robustos.

README

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

Crypto Sentiment MCP Server

An MCP server that delivers cryptocurrency sentiment analysis to AI agents, leveraging Santiment's aggregated social media and news data to track market mood and detect emerging trends.

GitHub License Python Version Status

Features

  • Sentiment Analysis: Retrieve sentiment balance (positive vs. negative) for specific cryptocurrencies.
  • Social Volume Tracking: Monitor total social media mentions and detect significant shifts (spikes or drops).
  • Social Dominance: Measure the share of discussions an asset occupies in crypto media.
  • Trending Words: Identify the most popular terms trending in cryptocurrency discussions.

Tools

Tool NameDescriptionParameters
get_sentiment_balanceGet the average sentiment balance for an asset over a specified period.asset: str, days: int = 7
get_social_volumeFetch the total number of social media mentions for an asset.asset: str, days: int = 7
alert_social_shiftDetect significant spikes or drops in social volume compared to the previous average.asset: str, threshold: float = 50.0, days: int = 7
get_trending_wordsRetrieve the top trending words in crypto discussions, ranked by score over a period.days: int = 7, top_n: int = 5
get_social_dominanceMeasure the percentage of crypto media discussions dominated by an asset.asset: str, days: int = 7

Prerequisites

  • Python: 3.10 or higher
  • Santiment API Key: Obtain a free or paid key from Santiment.

Installation

  1. Clone the Repository:

    git clone https://github.com/kukapay/crypto-sentiment-mcp.git
    cd crypto-sentiment-mcp
    
  2. Configure Client:

    {
      "mcpServers": {
        "crypto-sentiment-mcp": {
          "command": "uv",
          "args": ["--directory", "path/to/crypto-sentiment-mcp", "run", "main.py"],
          "env": {
            "SANTIMENT_API_KEY": "your_api_key_here"
          }
        }
      }
    }
    

Examples

Below are examples of natural language inputs and their corresponding outputs when interacting with the server via an MCP-compatible client:

  • Input: "What's the sentiment balance for Bitcoin over the last week?"

    • Output: "Bitcoin's sentiment balance over the past 7 days is 12.5."
  • Input: "How many times has Ethereum been mentioned on social media in the past 5 days?"

    • Output: "Ethereum's social volume over the past 5 days is 8,432 mentions."
  • Input: "Tell me if there's been a big change in Bitcoin's social volume recently, with a 30% threshold."

    • Output: "Bitcoin's social volume spiked by 75.0% in the last 24 hours, from an average of 1,000 to 1,750."
  • Input: "What are the top 3 trending words in crypto over the past 3 days?"

    • Output: "Top 3 trending words over the past 3 days: 'halving', 'bullrun', 'defi'."
  • Input: "How dominant is Ethereum in social media discussions this week?"

    • Output: "Ethereum's social dominance over the past 7 days is 18.7%."

License

This project is licensed under the MIT License - see the LICENSE file for details.

Ver o original no GitHub

Bom para

Relacionados