Bitcoin MCP Server

Servidor MCP dedicado ao ecossistema Bitcoin para traders, analistas, desenvolvedores e mais.

GitHub
6

Documentação

Bitcoin MCP Server

Um servidor abrangente do Model Context Protocol (MCP) que traz dados e funcionalidades do Bitcoin diretamente para assistentes de IA como Claude, ChatGPT e outras plataformas compatíveis com MCP.

Bitcoin Bitcoin MCP License: MIT Python 3.12

📋 Sumário

🤖 O que é MCP?

O Model Context Protocol (MCP) é um padrão aberto que permite que assistentes de IA se conectem com segurança a fontes de dados e ferramentas externas. Pense nele como um adaptador universal que permite que modelos de IA interajam com seus aplicativos, bancos de dados e APIs de forma padronizada.

Principais benefícios do MCP

  • Integração plug-and-play: Conecte assistentes de IA a ferramentas externas sem código personalizado
  • Seguro: Acesso controlado a dados e operações
  • Universal: Funciona em diferentes plataformas de IA (Claude, ChatGPT, etc.)
  • Modular: Fácil de adicionar, remover ou atualizar recursos

Saiba mais em modelcontextprotocol.io

💡 Por que usar o Bitcoin MCP Server?

O Bitcoin MCP Server capacita assistentes de IA com dados e análises do Bitcoin em tempo real:

  • Dados em tempo real: Acesse preços atuais do Bitcoin, dados de mercado e estatísticas da rede
  • Análise de blockchain: Consulte blocos, transações e endereços diretamente
  • Insights de mineração: Obtenha informações sobre hashrate, dificuldade e pools de mineração
  • Inteligência de mercado: Acompanhe movimentos de preço, volume e capitalização de mercado
  • Saúde da rede: Monitore o status do mempool, estimativas de taxas e estatísticas de nós

Nenhuma experiência em Bitcoin é necessária — basta fazer perguntas em linguagem natural, e a IA cuida das consultas técnicas para você!

✨ Recursos

  • Visão geral da rede: Estatísticas em tempo real da rede Bitcoin, incluindo hashrate, dificuldade, produção de blocos e volume de transações
  • Análise de transações: Informações detalhadas de transações com detalhamento de entradas/saídas, análise de taxas e status de confirmação
  • Inteligência de endereços: Análise completa de endereços, incluindo saldo, histórico de transações e gerenciamento de UTXO
  • Explorador de blocos: Acesso a dados de blocos com informações de pool de mineração, contagem de transações, taxas e carimbos de data/hora
  • Dados de mercado: Preço do Bitcoin em tempo real, capitalização de mercado, volume de negociação e análise de desempenho em múltiplos períodos
  • Insights de mineração: Ranking das principais pools de mineração, distribuição de hashrate, estatísticas de dominância da rede e tendências históricas de 3 meses
  • Recomendações de taxas: Estimativas dinâmicas de taxas para diferentes velocidades de confirmação (mais rápida, meia hora, padrão, econômica)
  • Sentimento do mercado: Acompanhamento do sentimento da comunidade e Índice de Medo e Ganância com dados históricos de 7 dias
  • Análises em alta: Descubra criptomoedas em tendência, coleções de NFTs e categorias

💼 Casos de uso

Para investidores e traders

img

Para desenvolvedores e analistas

img

Para pesquisadores e educadores

img

Para inteligência de negócios

img

Você pode usar estes exemplos:

  • Transação: a1075db55d416d3ca199f55b6084e2115b9345e16c5cf302fc80e9d5fbf5d48d
  • Endereço: 1Ay8vMC7R1UbyCCZRVULMV7iQpHSAbguJP
  • Bloco (altura): 933135

🚀 Instalação

Pré-requisitos

  • Python 3.12 instalado no seu sistema
  • Gerenciador de pacotes UV (obrigatório)
  • Um cliente de IA compatível com MCP (por exemplo, Claude Desktop)

Opção 1: Usando UV (recomendado)

  1. Instale o UV (se ainda não estiver instalado). O UV é um instalador e resolvedor de pacotes Python rápido.
  • Linux:
curl -LsSf https://astral.sh/uv/install.sh | sh
  • Windows:
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Reinicie a janela do seu terminal após a instalação.

  1. Clone o repositório:
git clone https://github.com/teamssUTXO/bitcoin_mcp.git
cd bitcoin_mcp
  1. Instale as dependências:
uv venv
uv pip install -e .
  1. Instale no Claude Desktop:
uv run mcp install src/main.py

Consulte Como configurar o MCP Server

Opção 2: Usando Python/Pip

  1. Clone o repositório:
git clone https://github.com/teamssutxo/bitcoin_mcp.git
cd bitcoin_mcp
  1. Crie um ambiente virtual (recomendado):
python -m venv venv
source venv/bin/activate  # On Windows: .\venv\Scripts\activate
  1. Instale as dependências:
pip install -r requirements.txt
  1. Execute o servidor com o Claude Desktop:

Siga o guia de configuração do Claude: Config.README.md

Opção 3: Usando Docker

Consulte README.Docker.md para instruções detalhadas de implantação com Docker.

Verificar a saúde do servidor

Para verificar se o servidor está funcionando corretamente, use o endpoint /health.

Configuração da porta

Personalize a porta com --port 8000 ou -p 8000. Padrão: 3000.

🛠️ Ferramentas disponíveis

O Bitcoin MCP Server fornece as seguintes ferramentas organizadas por categoria:

📬 Ferramentas de endereço

  • get_address_overview
  • get_info_about_address

📦 Ferramentas de bloco

  • get_10_latest_blocks_informations
  • get_block_hash_with_height
  • get_summary_of_latest_block

💸 Ferramentas de transação

  • get_bitcoin_transaction_infos
  • get_transaction_input_output
  • get_transactions_of_address

💰 Ferramentas de mercado

  • get_bitcoin_price_usd
  • get_bitcoin_market_data
  • get_cryptomarket_overview
  • get_bitcoin_market_sentiment
  • get_trending_coins
  • get_trending_categories
  • get_trending_nfts

⛏️ Ferramentas de mineração

  • get_mining_pools_hashrates_3month
  • get_top_10_mining_pools_rank
  • get_bitcoin_network_mining_pools_statistics
  • get_top1_mining_pool
  • get_mining_pool_by_slugl

🌐 Ferramentas de rede

  • get_bitcoin_network_overview
  • get_bitcoin_network_recommended_fees
  • get_bitcoin_network_health

Total: mais de 20 ferramentas e crescendo!

Para documentação detalhada das ferramentas, consulte a ajuda integrada em cada módulo de ferramenta ou use o MCP Inspector.

⚙️ Configuração

Configuração rápida para Claude Desktop

Após a instalação, configure o Claude Desktop para usar o Bitcoin MCP Server:

uv run mcp install src/main.py

Este comando automaticamente:

  • Detecta sua instalação do Claude Desktop
  • Cria a configuração necessária
  • Registra todas as ferramentas do Bitcoin

Em seguida, reinicie o Claude Desktop para ativar o servidor.

Configuração manual para Claude Desktop

Para instruções detalhadas de configuração manual para Claude Desktop e outras plataformas, consulte como configurar o MCP Server.

Configurar o servidor

Você pode personalizar o comportamento do servidor editando o arquivo de configuração localizado em src/config.py.

Opções de configuração disponíveis

Endpoints da API

  • MEMPOOL_API_URL: Endpoint da API Mempool.space (padrão: https://mempool.space/api)
  • COINGECKO_API_URL: Endpoint da API CoinGecko (padrão: https://api.coingecko.com/api/v3)
  • BLOCKCHAIN_INFO_API_URL: Endpoint da API Blockchain.info (padrão: https://blockchain.info)
  • HIRO_API_URL: Endpoint da API Hiro (padrão: https://api.hiro.so)
  • ALTERNATIVE_API_URL: Endpoint da API Alternative.me (padrão: https://api.alternative.me)

Constantes do Bitcoin

  • SATOSHI: Fator de conversão de satoshi (padrão: 100_000_000)

Desempenho e confiabilidade

  • ENABLE_CACHE: Ativar cache de respostas (padrão: True)
  • ENABLE_RETRY: Ativar tentativas automáticas em falhas (padrão: True)
  • CACHE_TTL_TIME: Tempo de vida do cache em segundos (padrão: 60)
  • MAX_RETRIES: Número máximo de tentativas para solicitações com falha (padrão: 3)

Configurações de tempo limite

  • API_CONNECT_TIMEOUT: Tempo limite de conexão em segundos (padrão: 5.0)
  • API_READ_TIMEOUT: Tempo limite de leitura em segundos (padrão: 30.0)
  • API_WRITE_TIMEOUT: Tempo limite de escrita em segundos (padrão: 10.0)
  • API_POOL_TIMEOUT: Tempo limite do pool de conexões em segundos (padrão: 5.0)

Configuração de registro (logging)

  • LOGGER_NAME: Nome do logger (padrão: "bitcoin_mcp_server")
  • LOG_DIR: Diretório para arquivos de log (padrão: "../logs")
  • LOG_LEVEL: Nível de registro - DEBUG, INFO, WARNING, ERROR (padrão: "INFO")
  • LOGGER_BACKUP_COUNT: Número de arquivos de log a reter (padrão: 30)
  • LOGGER_CONSOLE_OUTPUT: Ativar registro no console (padrão: True)

Como modificar

Edite src/config.py e altere os valores:

# Example: Increase cache time and reduce retries
CACHE_TTL_TIME: int = 300  # 5 minutes instead of 1
MAX_RETRIES: int = 2       # 2 retries instead of 3

# Example: Enable debug logging
LOG_LEVEL: str = "DEBUG"

Observação: Reinicie o servidor após fazer alterações na configuração para que elas entrem em vigor.

🔑 Informações da API

Nenhuma chave de API necessária!

O Bitcoin MCP Server usa APIs públicas e gratuitas que não exigem autenticação ou chaves de API. Isso torna a configuração incrivelmente simples — basta instalar e usar!

Fontes de dados

O servidor agrega dados de várias fontes confiáveis:

Política de uso justo

Embora essas APIs sejam gratuitas e não exijam chaves, use-as com responsabilidade:

  • Evite solicitações excessivas: Não envie spam às APIs com consultas rápidas e repetidas
  • Limitação de taxa: O servidor implementa atrasos razoáveis entre solicitações
  • Seja respeitoso: Esses serviços são fornecidos gratuitamente à comunidade
  • Use cache quando possível: Os resultados são armazenados em cache para minimizar solicitações redundantes

Observação: Se você planeja usar este servidor em alto volume ou em ambiente de produção, considere usar chaves de API ou hospedar nós do Bitcoin Core para acesso aos dados.

⚠️ Considerações de uso

Limites de mensagens

Usar servidores MCP consumirá mais tokens da cota de mensagens do seu assistente de IA porque:

  • Cada chamada de ferramenta requer contexto adicional a ser enviado
  • Os resultados das APIs aumentam a contagem total de tokens
  • Consultas complexas podem exigir várias chamadas de ferramentas

Impacto: Você pode atingir seu limite diário de mensagens mais rapidamente ao usar extensivamente as ferramentas do Bitcoin MCP.

Limitação de taxa

Embora as APIs sejam gratuitas, há limites de taxa. O uso intensivo pode resultar em bloqueios temporários. Consulte o site do cliente para limites específicos de uso da API.

CORS

A configuração atual permite solicitações de qualquer origem, o que é aceitável para desenvolvimento local, mas deve ser explicitamente restringido antes de qualquer implantação em produção.

Observe também que combinar allow_origins=["*"] com allow_credentials=True é tecnicamente inválido de acordo com a especificação CORS — os navegadores rejeitarão solicitações entre origens com credenciais quando a origem for um curinga. Considere desativar as credenciais ou listar explicitamente as origens permitidas.

🤝 Contribuição

Aceitamos contribuições da comunidade! Seja corrigindo bugs, adicionando recursos ou melhorando a documentação, sua ajuda é apreciada ❤️.

Como contribuir

  1. Faça um fork do repositório
  2. Crie um branch de recurso
  3. Faça suas alterações
  4. Teste com o MCP Inspector
  5. Faça commit das suas alterações
  6. Envie para o seu branch
  7. Abra um Pull Request

Consulte CONTRIBUTING.md para diretrizes detalhadas.

📄 Licença

Este projeto é licenciado sob a Licença MIT — consulte o arquivo LICENSE para obter detalhes.

🔒 Segurança

Para preocupações de segurança ou relatórios de vulnerabilidades, consulte nossa Política de Segurança.

Este projeto não foi "vibe-coded".

bitcoin love