Bitcoin MCP Server

Servidor MCP dedicado al ecosistema Bitcoin para traders, analistas, desarrolladores y más.

Documentación

Bitcoin MCP Server

Un servidor integral del Protocolo de Contexto de Modelos (MCP) que lleva los datos y la funcionalidad de Bitcoin directamente a asistentes de IA como Claude, ChatGPT y otras plataformas compatibles con MCP.

🤖 ¿Qué es MCP?

El Protocolo de Contexto de Modelos (MCP) es un estándar abierto que permite a los asistentes de IA conectarse de forma segura a fuentes de datos y herramientas externas. Piénsalo como un adaptador universal que permite a los modelos de IA interactuar con tus aplicaciones, bases de datos y APIs de manera estandarizada.

Beneficios Clave de MCP

Integración Plug-and-Play: Conecta asistentes de IA a herramientas externas sin código personalizado
Seguro: Acceso controlado a datos y operaciones
Universal: Funciona en diferentes plataformas de IA (Claude, ChatGPT, etc.)
Modular: Fácil de añadir, eliminar o actualizar capacidades

Aprende más en modelcontextprotocol.io

💡 ¿Por qué usar Bitcoin MCP Server?

Bitcoin MCP Server capacita a los asistentes de IA con datos de Bitcoin en tiempo real y capacidades de análisis:

Datos en Tiempo Real: Accede a precios actuales de Bitcoin, datos de mercado y estadísticas de red
Análisis de Blockchain: Consulta bloques, transacciones y direcciones directamente
Información de Minería: Obtén hashrate, dificultad e información de pools de minería
Inteligencia de Mercado: Sigue movimientos de precios, volumen y capitalización de mercado
Salud de la Red: Monitorea el estado del mempool, estimaciones de tarifas y estadísticas de nodos

No se requiere experiencia en Bitcoin — solo haz preguntas en lenguaje natural, y la IA maneja las consultas técnicas por ti.

✨ Características

Resumen de la Red: Estadísticas de la red Bitcoin en tiempo real, incluyendo hashrate, dificultad, producción de bloques y volumen de transacciones
Análisis de Transacciones: Información detallada de transacciones con desglose de entradas/salidas, análisis de tarifas y estado de confirmación
Inteligencia de Direcciones: Análisis completo de direcciones, incluyendo saldo, historial de transacciones y gestión de UTXO
Explorador de Bloques: Acceso a datos de bloques con información de pools de minería, conteo de transacciones, tarifas y marcas de tiempo
Datos de Mercado: Precio de Bitcoin en tiempo real, capitalización de mercado, volumen de negociación y análisis de rendimiento en múltiples marcos temporales
Información de Minería: Ranking de los principales pools de minería, distribución de hashrate, estadísticas de dominancia de red y tendencias históricas de 3 meses
Recomendaciones de Tarifas: Estimaciones dinámicas de tarifas para diferentes velocidades de confirmación (más rápida, media hora, estándar, económica)
Sentimiento del Mercado: Seguimiento del sentimiento de la comunidad e Índice de Miedo y Codicia con datos históricos de 7 días
Análisis de Tendencias: Descubre criptomonedas, colecciones NFT y categorías en tendencia

💼 Casos de Uso

Para Inversores y Comerciantes

Para Desarrolladores y Analistas

Para Investigadores y Educadores

Para Inteligencia Empresarial

Puedes usar estos ejemplos:

Transacción: a1075db55d416d3ca199f55b6084e2115b9345e16c5cf302fc80e9d5fbf5d48d
Dirección: 1Ay8vMC7R1UbyCCZRVULMV7iQpHSAbguJP
Bloque (altura): 933135

🚀 Instalación

Requisitos Previos

Python 3.12 instalado en tu sistema
UV gestor de paquetes (obligatorio)
Un cliente de IA compatible con MCP (por ejemplo, Claude Desktop)

Opción 1: Usando UV (Recomendado)

Instala UV (si aún no está instalado). UV es un instalador y resolutor de paquetes de 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"

Reinicia tu ventana de línea de comandos después de instalarlo.

Clona el repositorio:

git clone https://github.com/teamssUTXO/bitcoin_mcp.git
cd bitcoin_mcp

Instala las dependencias:

uv venv
uv pip install -e .

Instala en Claude Desktop:

uv run mcp install src/main.py

Consulta Cómo configurar MCP Server

Opción 2: Usando Python/Pip

Clona el repositorio:

git clone https://github.com/teamssutxo/bitcoin_mcp.git
cd bitcoin_mcp

Crea un entorno virtual (recomendado):

python -m venv venv
source venv/bin/activate  # On Windows: .\venv\Scripts\activate

Instala las dependencias:

pip install -r requirements.txt

Ejecuta el servidor con Claude Desktop:

Sigue la guía de configuración de Claude: Config.README.md

Opción 3: Usando Docker

Consulta README.Docker.md para instrucciones detalladas de implementación con Docker.

Verificar la salud del servidor

Para comprobar que el servidor funciona correctamente, usa el endpoint /health.

Configuración del Puerto

Personaliza el puerto con --port 8000 o -p 8000. Valor predeterminado: 3000.

🛠️ Herramientas Disponibles

Bitcoin MCP Server proporciona las siguientes herramientas organizadas por categoría:

📬 Herramientas de Direcciones

get_address_overview
get_info_about_address

📦 Herramientas de Bloques

get_10_latest_blocks_informations
get_block_hash_with_height
get_summary_of_latest_block

💸 Herramientas de Transacciones

get_bitcoin_transaction_infos
get_transaction_input_output
get_transactions_of_address

💰 Herramientas 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

⛏️ Herramientas de Minería

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

🌐 Herramientas de Red

get_bitcoin_network_overview
get_bitcoin_network_recommended_fees
get_bitcoin_network_health

Total: ¡Más de 20 herramientas y creciendo!

Para documentación detallada de herramientas, consulta la ayuda integrada en cada módulo de herramientas o usa MCP Inspector.

⚙️ Configuración

Configuración Rápida para Claude Desktop

Después de la instalación, configura Claude Desktop para usar Bitcoin MCP Server:

uv run mcp install src/main.py

Este comando automáticamente:

Detecta tu instalación de Claude Desktop
Crea la configuración necesaria
Registra todas las herramientas de Bitcoin

Luego reinicia Claude Desktop para activar el servidor.

Configuración Manual para Claude Desktop

Para instrucciones detalladas de configuración manual para Claude Desktop y otras plataformas, consulta cómo configurar MCP Server.

Configurar el Servidor

Puedes personalizar el comportamiento del servidor editando el archivo de configuración ubicado en src/config.py.

Opciones de Configuración Disponibles

Endpoints de API

MEMPOOL_API_URL: Endpoint de la API de Mempool.space (predeterminado: https://mempool.space/api)
COINGECKO_API_URL: Endpoint de la API de CoinGecko (predeterminado: https://api.coingecko.com/api/v3)
BLOCKCHAIN_INFO_API_URL: Endpoint de la API de Blockchain.info (predeterminado: https://blockchain.info)
HIRO_API_URL: Endpoint de la API de Hiro (predeterminado: https://api.hiro.so)
ALTERNATIVE_API_URL: Endpoint de la API de Alternative.me (predeterminado: https://api.alternative.me)

Constantes de Bitcoin

SATOSHI: Factor de conversión de Satoshi (predeterminado: 100_000_000)

Rendimiento y Fiabilidad

ENABLE_CACHE: Habilitar caché de respuestas (predeterminado: True)
ENABLE_RETRY: Habilitar reintentos automáticos en fallos (predeterminado: True)
CACHE_TTL_TIME: Tiempo de vida de la caché en segundos (predeterminado: 60)
MAX_RETRIES: Número máximo de intentos de reintento para solicitudes fallidas (predeterminado: 3)

Configuración de Tiempo de Espera

API_CONNECT_TIMEOUT: Tiempo de espera de conexión en segundos (predeterminado: 5.0)
API_READ_TIMEOUT: Tiempo de espera de lectura en segundos (predeterminado: 30.0)
API_WRITE_TIMEOUT: Tiempo de espera de escritura en segundos (predeterminado: 10.0)
API_POOL_TIMEOUT: Tiempo de espera del pool de conexiones en segundos (predeterminado: 5.0)

Configuración de Registro

LOGGER_NAME: Nombre del registrador (predeterminado: "bitcoin_mcp_server")
LOG_DIR: Directorio para archivos de registro (predeterminado: "../logs")
LOG_LEVEL: Nivel de registro - DEBUG, INFO, WARNING, ERROR (predeterminado: "INFO")
LOGGER_BACKUP_COUNT: Número de archivos de registro a conservar (predeterminado: 30)
LOGGER_CONSOLE_OUTPUT: Habilitar registro en consola (predeterminado: True)

Cómo Modificar

Edita src/config.py y cambia los 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"

Nota: Reinicia el servidor después de realizar cambios de configuración para que surtan efecto.

🔑 Información de la API

¡No se Requieren Claves de API!

Bitcoin MCP Server utiliza APIs públicas y gratuitas que no requieren autenticación ni claves de API. Esto hace que la configuración sea increíblemente simple: ¡solo instala y listo!

Fuentes de Datos

El servidor agrega datos de múltiples fuentes confiables:

Política de Uso Justo

Si bien estas APIs son gratuitas y no requieren claves, úsalas de manera responsable:

Evita solicitudes excesivas: No satures las APIs con consultas rápidas y repetidas
Límite de velocidad: El servidor implementa demoras razonables entre solicitudes
Sé respetuoso: Estos servicios se proporcionan de forma gratuita a la comunidad
Usa caché cuando sea posible: Los resultados se almacenan en caché para minimizar solicitudes redundantes

Nota: Si planeas usar este servidor a alto volumen o en un entorno de producción, considera usar claves de API o alojar nodos de Bitcoin Core para el acceso a datos.

⚠️ Consideraciones de Uso

Límites de Mensajes

Usar servidores MCP consumirá más tokens del límite de mensajes de tu asistente de IA porque:

Cada llamada a herramienta requiere contexto adicional que se envía
Los resultados de las APIs se suman al conteo total de tokens
Las consultas complejas pueden requerir múltiples llamadas a herramientas

Impacto: Puedes alcanzar tu límite diario de mensajes más rápido al usar las herramientas de Bitcoin MCP de manera intensiva.

Límite de Velocidad

Si bien las APIs son gratuitas, se aplican límites de velocidad. El uso intensivo puede resultar en bloqueos temporales. Consulta el sitio web del cliente para conocer los límites específicos de uso de la API.

CORS

La configuración actual permite solicitudes desde cualquier origen, lo cual es aceptable para desarrollo local, pero debe restringirse explícitamente antes de cualquier implementación en producción.

Ten en cuenta también que combinar allow_origins=["*"] con allow_credentials=True es técnicamente inválido según la especificación CORS: los navegadores rechazarán solicitudes entre orígenes con credenciales cuando el origen es un comodín. Considera deshabilitar las credenciales o listar explícitamente los orígenes permitidos.

🤝 Contribuciones

¡Damos la bienvenida a contribuciones de la comunidad! Ya sea corrigiendo errores, añadiendo funciones o mejorando la documentación, tu ayuda es apreciada ❤️.

Cómo Contribuir

Haz un fork del repositorio
Crea una rama de características
Realiza tus cambios
Prueba con MCP Inspector
Confirma tus cambios
Sube a tu rama
Abre una Solicitud de Extracción (Pull Request)

Consulta CONTRIBUTING.md para pautas detalladas.

📄 Licencia

Este proyecto está licenciado bajo la Licencia MIT — consulta el archivo LICENSE para más detalles.

🔒 Seguridad

Para preocupaciones de seguridad o informes de vulnerabilidades, consulta nuestra Política de Seguridad.

Este proyecto no fue codificado al azar.