Coinbase Chat MCP

Accede a datos de criptomonedas, información de mercado y perspectivas de trading desde la API pública de Coinbase.

GitHub
3
Prueba este MCPPatrocinado

Documentación

Coinbase Chat MCP

MIT License TypeScript Model Context Protocol

Un servidor Model Context Protocol (MCP) de código abierto y aplicación web para una integración perfecta con la API pública de Coinbase. Este proyecto permite a agentes de IA, LLMs y desarrolladores interactuar con datos de criptomonedas, información de mercado y perspectivas de trading a través de una interfaz estandarizada y segura.

🎯 ¿Qué es Real vs. Simulado?

ComponenteEstadoFuente
💰 Precios de Criptomonedas✅ RealCoinbase Public API
📊 Estadísticas de Mercado✅ RealCoinbase Public API
📈 Datos Históricos✅ RealCoinbase Public API
🤖 Chat IA GPT-4✅ RealOpenAI
🎤 Entrada de Voz (Whisper)✅ RealOpenAI
🔊 Texto a Voz✅ RealOpenAI
🔌 Protocolo MCP✅ RealSDK Oficial
💵 Saldos de Billetera🎮 SimuladoDemo en memoria
💸 Transacciones🎮 SimuladoSolo educativo
🍺 Compras de Cerveza🎮 SimuladoEconomía virtual

¡Perfecto para aprender sobre cripto sin riesgo financiero! 🎓

🌟 Características

🔌 Servidor MCP

  • Cumplimiento MCP Completo - Implementa la especificación completa del Model Context Protocol
  • 13 Herramientas Potentes - Precios en tiempo real, datos históricos, estadísticas de mercado, búsqueda de activos, análisis técnico y simulación de transacciones
  • 🍺₿ Economía Circular - Flujo completo: USD → Cripto → ¡Cerveza Virtual!
  • Sugerencias Inteligentes - La IA te guía para comprar cripto si es necesario antes de las compras
  • Billetera e Inventario Virtuales - Seguimiento de saldos, transacciones y colección de cerveza
  • Integración con Cursor - Preconfigurado para Cursor IDE con .cursor/mcp.json
  • Compatible con Claude Desktop - Funciona con cualquier cliente compatible con MCP
  • Seguro y Rápido - Limitación de velocidad integrada y caché inteligente

💬 Interfaz de Chat Interactiva

  • Conversaciones Impulsadas por IA - Integración GPT-4 para discusiones cripto inteligentes
  • Entrada de Voz - Haz tus preguntas con soporte multilingüe mediante OpenAI Whisper
  • Texto a Voz - Respuestas de IA leídas en voz alta con voces naturales
  • Persistencia de Sesiones - Historial de chat guardado entre pestañas del navegador y reinicios
  • Gestión de Sesiones - Crea, cambia y gestiona múltiples sesiones de chat
  • Titulación Automática - Sesiones tituladas automáticamente desde el primer mensaje del usuario
  • Sincronización en Tiempo Real - Actualizaciones en vivo al cambiar entre sesiones

🚀 Explorador de API

  • Documentación Interactiva - Interfaz de prueba en vivo para las 8 herramientas MCP
  • Pruebas en Tiempo Real - Ejecuta llamadas API directamente desde el navegador
  • Generación de Código - Ejemplos cURL y JavaScript generados automáticamente
  • Copiar al Portapapeles - Fácil intercambio e integración de código
  • Cobertura Integral - Todos los endpoints documentados con parámetros y ejemplos

🎨 Frontend Moderno

  • UI Hermosa - Diseño limpio y responsivo con TailwindCSS
  • Datos en Tiempo Real - Precios de criptomonedas en vivo y actualizaciones de mercado
  • Múltiples Páginas - Panel de control, Mercados, Activos, Análisis, Chat y Explorador de API
  • Compatible con Móviles - Diseño responsivo que funciona en todos los dispositivos

🚀 Inicio Rápido

Requisitos Previos

  • Node.js 18+
  • npm 9+

Instalación

  1. Clonar el repositorio

    git clone https://github.com/your-username/coinbase-chat-mcp.git
cd coinbase-chat-mcp

  2. Instalar dependencias

    npm install
# Install dependencies for all workspaces
cd mcp-server && npm install && cd ..
cd frontend && npm install && cd ..
cd api-server && npm install && cd ..

  3. Configurar variables de entorno (Opcional para funciones de IA)

    cd frontend
# Create .env file with your OpenAI API key for voice features
echo "VITE_OPENAI_API_KEY=your_openai_api_key_here" > .env
cd ..

  4. Compilar el servidor MCP

    cd mcp-server
npm run build
cd ..

  5. Iniciar servidores de desarrollo

    # Start API server (port 3002)
cd api-server && npm run dev &

# Start frontend (port 5173)
cd frontend && npm run dev &

🤖 Integración MCP

Configuración en Cursor IDE (Recomendado)

El proyecto incluye configuraciones MCP de Cursor preconfiguradas:

  1. Configuración Automática - .cursor/mcp.json ya está configurado
  2. Reiniciar Cursor - El servidor MCP se cargará automáticamente con 8 herramientas disponibles
  3. Probar Integración - Intenta preguntar: "¿Cuál es el precio actual de Bitcoin?"

Configuración en Claude Desktop

Añade a tu configuración de Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "coinbase-mcp": {
      "command": "node",
      "args": ["/path/to/coinbase-chat-mcp/mcp-server/dist/index.js"],
      "env": {
        "COINBASE_API_URL": "https://api.coinbase.com/v2",
        "LOG_LEVEL": "info"
      }
    }
  }
}

Herramientas MCP Disponibles

📊 Herramientas de Datos de Mercado (8)

  1. get_spot_price - Precios actuales de criptomonedas
  2. get_historical_prices - Datos históricos de precios con rangos de tiempo
  3. get_exchange_rates - Tipos de cambio de monedas fiduciarias
  4. search_assets - Busca criptomonedas y activos
  5. get_asset_details - Información detallada de activos
  6. get_market_stats - Estadísticas de mercado de 24 horas
  7. get_popular_pairs - Pares de trading populares
  8. analyze_price_data - Análisis técnico (volatilidad, tendencias, soporte/resistencia)

🍺₿ Herramientas de Transacción Demo (5) - ¡NUEVAS!

  1. calculate_beer_cost - Convierte dinero de cerveza a cantidades cripto
  2. simulate_btc_purchase - Simula compra de cripto con USD
  3. buy_virtual_beer 🔥 - ¡Compra cerveza virtual CON cripto! (Economía circular)
  4. get_virtual_wallet - Ver saldo y estadísticas de la billetera demo
  5. get_transaction_history - Ver historial de transacciones simulado

🎯 Intenta preguntar: "¡Cómprame una cerveza!" → La IA te guiará a través de USD→BTC→¡Cerveza! 📖 Documentación completa: DEMO_TRANSACTIONS.md • CIRCULAR_ECONOMY.md

🏗️ Arquitectura

Descripción General del Sistema

Este proyecto utiliza una arquitectura híbrida que combina:

  • Datos de mercado reales de Coinbase Public API
  • Billetera simulada para transacciones cripto educativas
  • Protocolo MCP oficial para integración con agentes de IA
  • Stack web moderno para una UX hermosa
┌─────────────┐  ┌─────────────┐  ┌─────────────┐
│ Cursor IDE  │  │ Web Browser │  │Claude Desktop│
│ (MCP Client)│  │ (React App) │  │ (MCP Client)│
└──────┬──────┘  └──────┬──────┘  └──────┬──────┘
       │                │                │
       └────────────────┴────────────────┘
                        │
       ┌────────────────┴────────────────┐
       │                                 │
       ▼                                 ▼
┌──────────────┐              ┌──────────────────┐
│  MCP Server  │              │   API Server     │
│  (13 tools)  │              │   (REST API)     │
└──────┬───────┘              └────────┬─────────┘
       │                               │
       └───────────┬───────────────────┘
                   │
       ┌───────────┴───────────┐
       │                       │
       ▼                       ▼
┌──────────────┐      ┌─────────────────┐
│ Coinbase API │      │ Demo Wallet     │
│ (Real Data)  │      │ (Simulated)     │
└──────────────┘      └─────────────────┘

📖 Arquitectura Detallada: Consulta ARCHITECTURE.md para:

  • Diagramas de componentes
  • Ejemplos de código
  • Desglose real vs. simulado
  • Comparación con Base MCP y x402
  • Inmersión técnica profunda

Componentes Clave

coinbase-chat-mcp/
├── mcp-server/          # MCP Protocol Server (13 tools)
├── api-server/          # Express REST API Server  
├── frontend/            # React + TypeScript Frontend
│   ├── src/pages/       # Chat, Wallet, API Explorer
│   ├── src/components/  # Reusable UI components
│   └── src/services/    # AI, Voice, Chat sessions
├── docs/                # Comprehensive documentation
└── .cursor/             # Cursor IDE MCP configuration

Servidor MCP

Expone 13 herramientas a través del Model Context Protocol:

Herramientas de Datos de Mercado (8):

  • Precios en tiempo real, datos históricos, estadísticas de mercado
  • Búsqueda y detalles de activos, tipos de cambio
  • Análisis técnico (volatilidad, tendencias, soporte/resistencia)

Herramientas de Transacción (5):

  • 🍺₿ Calculadora de cerveza a cripto
  • Simulación de billetera virtual (USD → Cripto)
  • Economía circular (¡Cripto → Cerveza!)
  • Saldo e historial de transacciones

Aplicación Frontend

Aplicación React moderna con:

  • Chat IA - Impulsado por GPT-4 con entrada de voz 🎤 y TTS 🔊
  • Billetera Virtual - Compras cripto demo y economía de cerveza 🍺₿
  • Explorador de API - Documentación y pruebas interactivas
  • Tutorial - Guía de integración MCP paso a paso
  • Presentaciones - Visor de diapositivas de negocio

🔧 Configuración

Variables de Entorno

Crea archivos .env para la funcionalidad de chat IA:

# frontend/.env (Optional - for AI chat)
VITE_OPENAI_API_KEY=your_openai_api_key_here

Nota de Seguridad: El frontend incluye advertencias integradas sobre el uso de claves API en el lado del cliente y solo habilita las funciones de IA en modo de desarrollo.

🤖 Configuración de Chat IA y Funciones de Voz (Opcional)

Para habilitar la interfaz de chat impulsada por IA con capacidades de voz:

  1. Obtén una clave API de OpenAI: Visita OpenAI Platform
  2. Crea el archivo frontend/.env: 
    VITE_OPENAI_API_KEY=sk-your-actual-api-key-here
  3. Reinicia el frontend: ¡El chat usará GPT-4 para discusiones cripto inteligentes!

🎤 Funciones de Voz (Requiere clave API de OpenAI)

Una vez configurado, tendrás acceso a:

  • 🌐 Entrada de Voz Multilingüe - Haz preguntas en cualquier idioma usando OpenAI Whisper

    • Soporta más de 50 idiomas, incluyendo inglés, español, francés, alemán, ruso, chino, japonés y más
    • Transcripción de voz a texto en tiempo real
    • Haz clic en el botón morado de micrófono para comenzar a grabar

  • 🔊 Respuestas de Texto a Voz - Escucha las respuestas de IA leídas en voz alta

    • Haz clic en el ícono de altavoz en cualquier mensaje del asistente
    • Voces de sonido natural impulsadas por OpenAI TTS
    • Múltiples opciones de voz disponibles

  • ⚡ Modo de Respaldo - Sin clave de OpenAI, la Web Speech API básica proporciona entrada de voz solo en inglés

Nota: Sin la clave API, la interfaz de chat proporciona un mensaje de configuración útil y funcionalidad básica.

📚 Ejemplos de Uso

Herramientas MCP en Cursor/Claude

User: "What's the current Bitcoin price?"
Response: Current BTC-USD price: $100,608.65 USD

User: "Show me Ethereum's price trend over the last 7 days"
Response: [Historical price data with analysis]

User: "Analyze Bitcoin's volatility this month"
Response: [Technical analysis with volatility metrics]

User: "Buy me a beer worth of Bitcoin!" 🍺
Response: At $110,360 per BTC, $5 = 0.00004531 BTC
          ✅ Purchased! You now have 0.00004531 BTC

User: "Now buy a beer WITH that Bitcoin!"
Response: 🍺 Beer Purchased with Crypto!
          Paid: 0.00004531 BTC
          Received: 1 🍺
          🎉 Total beers in inventory: 1

User: "Show my wallet"
Response: 👛 Virtual Wallet
          💵 USD: $995.00
          🪙 BTC: 0.00000000
          🍺 Beers: 1
          Total transactions: 2

Aplicación Web Frontend

  • Visitar: http://localhost:3005
  • Chat: Conversaciones persistentes con gestión de sesiones
  • Chat por Voz: Haz clic en el micrófono para hacer preguntas por voz en cualquier idioma
  • Escuchar Respuestas: Haz clic en el ícono de altavoz en los mensajes para escucharlos en voz alta
  • Explorador de API: Prueba las 8 herramientas MCP de forma interactiva
  • Panel de Control: Resumen de mercado en tiempo real
  • Mercados: Estadísticas de trading detalladas

Uso Directo de la API

# Get current Bitcoin price
curl http://localhost:3002/api/v1/prices/BTC-USD

# Search for assets
curl http://localhost:3002/api/v1/assets/search?query=bitcoin

🛠️ Desarrollo

Características Clave Implementadas

  • ✅ Servidor MCP - 13 herramientas, cumplimiento total del protocolo
  • ✅ Integración con Cursor - Configuración MCP preconfigurada
  • ✅ Economía Circular 🍺₿ - Simulación completa USD→Cripto→Cerveza
  • ✅ Interfaz de Voz 🎤 - Entrada multilingüe mediante Whisper
  • ✅ Texto a Voz 🔊 - Respuestas de IA leídas en voz alta
  • ✅ Billetera Virtual - Compras cripto demo e inventario
  • ✅ Sesiones de Chat - Conversaciones persistentes con localStorage
  • ✅ Explorador de API - Documentación interactiva para todas las herramientas
  • ✅ Gestión de Sesiones - Crear, cambiar, eliminar sesiones de chat
  • ✅ Integración de IA - Conversaciones impulsadas por GPT-4 con orquestación de herramientas
  • ✅ UI de Transacciones - Recibos hermosos y retroalimentación visual
  • ✅ Seguridad - Limitación de velocidad, validación, manejo de errores

Scripts de Desarrollo

# Build MCP server
cd mcp-server && npm run build

# Start API server (development)
cd api-server && npm run dev

# Start frontend (development)  
cd frontend && npm run dev

# Test MCP server
cd mcp-server && npm test

Estructura del Proyecto

  • mcp-server/: Servidor MCP TypeScript con 13 herramientas (8 datos de mercado + 5 billetera)
  • api-server/: Servidor API REST Express.js con simulación de billetera
  • frontend/: React + TypeScript con TailwindCSS, funciones de voz, UI de billetera
  • docs/: Documentación integral (ARCHITECTURE.md, guías, etc.)
  • .cursor/: Configuración MCP de Cursor IDE

📖 Documentación

Documentación Principal

  • README.md - ¡Este archivo! Descripción general del proyecto e inicio rápido
  • ARCHITECTURE.md 🏗️ - Guía completa de arquitectura técnica
    • Diagramas del sistema y desglose de componentes
    • Componentes reales vs. simulados explicados
    • Ejemplos de código y flujo de datos
    • Comparación con Base MCP y x402
    • Inmersión profunda en el stack tecnológico

Guías de Funciones

  • DEMO_TRANSACTIONS.md 🍺₿ - Referencia de herramientas de transacción

    • Las 5 herramientas de billetera explicadas
    • Ejemplos de uso y escenarios
    • Referencia de API

  • CIRCULAR_ECONOMY.md 🔄 - Guía completa de economía

    • Flujo USD → Cripto → Cerveza
    • Sugerencias inteligentes cuando hay saldo insuficiente
    • Seguimiento de inventario
    • Desafíos y escenarios divertidos

  • CHAT_WALLET_INTEGRATION.md 💬 - Integración de chat

    • Uso de herramientas de billetera en conversación
    • Recibos de transacción visuales
    • Conversaciones de ejemplo

Configuración e Instalación

Documentación Interactiva

  • Explorador de API - Pruebas de API interactivas (cuando está en ejecución)
  • Swagger UI - Documentación de API REST (cuando está en ejecución)

✨ Actualizaciones Recientes

🍺₿ Economía Circular (¡Lo más reciente!)

  • ¡Compra cerveza virtual CON criptomonedas! - Flujo completo USD→Cripto→Cerveza
  • Guía de IA inteligente - Sugiere comprar cripto si el saldo es insuficiente
  • Seguimiento de inventario - Ve tu colección de cerveza en la billetera
  • Recibos de transacción - Retroalimentación visual hermosa en el chat
  • 13 herramientas MCP en total - 8 datos de mercado + 5 herramientas de transacción

🎤 Funciones de Voz e IA

  • Entrada de voz multilingüe - Haz preguntas en más de 50 idiomas (OpenAI Whisper)
  • Texto a voz - Escucha las respuestas de IA leídas en voz alta (OpenAI TTS)
  • Integración GPT-4 - Conversaciones inteligentes con orquestación de herramientas
  • Indicadores visuales de herramientas - Ve qué herramientas MCP se utilizaron

💰 Sistema de Billetera Virtual

  • Transacciones demo - Simulación segura de compra de cripto
  • Calculadora de cerveza - Forma divertida de entender el valor cripto
  • Precios en tiempo real - Usa datos en vivo de Coinbase
  • Historial de transacciones - Seguimiento de todas las compras
  • Vista de portafolio - Ve todos los saldos en un solo lugar

Gestión de Sesiones de Chat

  • Sesiones de chat persistentes en pestañas del navegador
  • Historial de sesiones con título automático
  • Cambio de sesión en tiempo real
  • Persistencia basada en localStorage
  • Patrón de observador para actualizaciones en vivo

Explorador de API

  • Pruebas interactivas para las 8 herramientas MCP
  • Respuestas de API en tiempo real
  • Generación de código (cURL, JavaScript)
  • Función de copiar al portapapeles
  • Documentación completa de parámetros

Integración con Cursor MCP

  • .cursor/mcp.json preconfigurado
  • Carga automática de las 8 herramientas MCP
  • Consultas de criptomonedas listas para usar
  • Flujo de trabajo de desarrollo profesional

🤝 Contribuciones

¡Damos la bienvenida a las contribuciones! Por favor, consulte nuestra Guía de Contribución para más detalles.

  1. Hacer un fork del repositorio
  2. Cree su rama de características (git checkout -b feature/amazing-feature)
  3. Realice sus cambios (git commit -m 'Add amazing feature')
  4. Empuje a la rama (git push origin feature/amazing-feature)
  5. Abra una Solicitud de Extracción

📋 Hoja de Ruta

  • v1.0: Servidor MCP principal con 8 herramientas
  • v1.1: Persistencia de sesiones de chat
  • v1.2: Explorador de API interactivo
  • v1.3: Integración con el IDE Cursor
  • v1.4: Transmisión en tiempo real con WebSocket
  • v1.5: Gráficos avanzados e indicadores técnicos
  • v2.0: Soporte para múltiples intercambios

🐛 Problemas Conocidos

  • Límite de velocidad en la API pública de Coinbase (60 solicitudes/hora para algunos endpoints)
  • Las sesiones de chat están limitadas a localStorage (máximo 10 sesiones por rendimiento)
  • Las claves de API del lado del cliente solo deben usarse en desarrollo

📄 Licencia

Este proyecto está bajo la Licencia MIT - consulte el archivo LICENCIA para más detalles.

🙏 Agradecimientos

  • Al equipo de Model Context Protocol por la excelente especificación
  • A Coinbase por proporcionar API públicas robustas
  • A Cursor por la excelente integración con MCP
  • A la comunidad de código abierto por las herramientas y bibliotecas invaluables

📞 Soporte

Hecho con ❤️ por Vladimir Bichev para las comunidades de criptomonedas e IA