Coinbase Chat MCP

Acesse dados de criptomoedas, informações de mercado e insights de negociação da API pública da Coinbase.

GitHub
3
Experimente este MCPPatrocinado

Documentação

Coinbase Chat MCP

MIT License TypeScript Model Context Protocol

Um servidor Model Context Protocol (MCP) de código aberto e aplicação web para integração perfeita com a API pública da Coinbase. Este projeto permite que agentes de IA, LLMs e desenvolvedores interajam com dados de criptomoedas, informações de mercado e insights de negociação através de uma interface padronizada e segura.

🎯 O que é Real vs. Simulado?

ComponenteStatusFonte
💰 Preços de Criptomoedas✅ RealAPI Pública da Coinbase
📊 Estatísticas de Mercado✅ RealAPI Pública da Coinbase
📈 Dados Históricos✅ RealAPI Pública da Coinbase
🤖 Chat IA GPT-4✅ RealOpenAI
🎤 Entrada de Voz (Whisper)✅ RealOpenAI
🔊 Texto para Fala✅ RealOpenAI
🔌 Protocolo MCP✅ RealSDK Oficial
💵 Saldos de Carteira🎮 SimuladoDemonstração em memória
💸 Transações🎮 SimuladoApenas educacional
🍺 Compras de Cerveja🎮 SimuladoEconomia virtual

Perfeito para aprender sobre cripto sem risco financeiro! 🎓

🌟 Recursos

🔌 Servidor MCP

  • Conformidade Total com MCP - Implementa a especificação completa do Model Context Protocol
  • 13 Ferramentas Poderosas - Preços em tempo real, dados históricos, estatísticas de mercado, busca de ativos, análise técnica e simulação de transações
  • 🍺₿ Economia Circular - Fluxo completo: USD → Cripto → Cerveja Virtual!
  • Sugestões Inteligentes - IA guia você para comprar cripto se necessário antes das compras
  • Carteira Virtual e Inventário - Acompanhe saldos, transações e coleção de cervejas
  • Integração com Cursor - Pré-configurado para Cursor IDE com .cursor/mcp.json
  • Compatível com Claude Desktop - Funciona com qualquer cliente compatível com MCP
  • Seguro e Rápido - Limitação de taxa integrada e cache inteligente

💬 Interface de Chat Interativa

  • Conversas com IA - Integração GPT-4 para discussões inteligentes sobre cripto
  • Entrada de Voz - Fale suas perguntas com suporte multilíngue via OpenAI Whisper
  • Texto para Fala - Respostas da IA lidas em voz alta com vozes naturais
  • Persistência de Sessão - Histórico de chat salvo entre abas do navegador e reinicializações
  • Gerenciamento de Sessões - Crie, alterne e gerencie múltiplas sessões de chat
  • Titulação Automática - Sessões intituladas automaticamente a partir da primeira mensagem do usuário
  • Sincronização em Tempo Real - Atualizações ao vivo ao alternar entre sessões

🚀 Explorador de API

  • Documentação Interativa - Interface de teste ao vivo para todas as 8 ferramentas MCP
  • Testes em Tempo Real - Execute chamadas de API diretamente do navegador
  • Geração de Código - Exemplos cURL e JavaScript gerados automaticamente
  • Copiar para Área de Transferência - Compartilhamento e integração de código facilitados
  • Cobertura Abrangente - Todos os endpoints documentados com parâmetros e exemplos

🎨 Frontend Moderno

  • UI Bonita - Design limpo e responsivo com TailwindCSS
  • Dados em Tempo Real - Preços de criptomoedas e atualizações de mercado ao vivo
  • Múltiplas Páginas - Dashboard, Mercados, Ativos, Análise, Chat e Explorador de API
  • Compatível com Dispositivos Móveis - Design responsivo funciona em todos os dispositivos

🚀 Início Rápido

Pré-requisitos

  • Node.js 18+
  • npm 9+

Instalação

  1. Clone o repositório

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

  2. Instale as dependências

    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. Configure as variáveis de ambiente (Opcional para recursos 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. Compile o servidor MCP

    cd mcp-server
npm run build
cd ..

  5. Inicie os servidores de desenvolvimento

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

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

🤖 Integração MCP

Configuração no Cursor IDE (Recomendado)

O projeto inclui configurações MCP pré-configuradas para Cursor:

  1. Configuração Automática - .cursor/mcp.json já está configurado
  2. Reinicie o Cursor - O servidor MCP carregará automaticamente com 8 ferramentas disponíveis
  3. Teste a Integração - Tente perguntar: "Qual é o preço atual do Bitcoin?"

Configuração no Claude Desktop

Adicione à configuração do seu 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"
      }
    }
  }
}

Ferramentas MCP Disponíveis

📊 Ferramentas de Dados de Mercado (8)

  1. get_spot_price - Preços atuais de criptomoedas
  2. get_historical_prices - Dados históricos de preços com intervalos de tempo
  3. get_exchange_rates - Taxas de câmbio de moedas fiduciárias
  4. search_assets - Encontre criptomoedas e ativos
  5. get_asset_details - Informações detalhadas de ativos
  6. get_market_stats - Estatísticas de mercado de 24 horas
  7. get_popular_pairs - Pares de negociação populares
  8. analyze_price_data - Análise técnica (volatilidade, tendências, suporte/resistência)

🍺₿ Ferramentas de Transação de Demonstração (5) - NOVO!

  1. calculate_beer_cost - Converta dinheiro de cerveja em quantidades de cripto
  2. simulate_btc_purchase - Simule a compra de cripto com USD
  3. buy_virtual_beer 🔥 - Compre cerveja virtual COM cripto! (Economia circular)
  4. get_virtual_wallet - Veja saldo e estatísticas da carteira de demonstração
  5. get_transaction_history - Veja o histórico de transações simulado

🎯 Experimente perguntar: "Compre uma cerveja para mim!" → A IA guiará você pelo fluxo USD→BTC→Cerveja! 📖 Documentação completa: DEMO_TRANSACTIONS.md • CIRCULAR_ECONOMY.md

🏗️ Arquitetura

Visão Geral do Sistema

Este projeto usa uma arquitetura híbrida combinando:

  • Dados reais de mercado da API Pública da Coinbase
  • Carteira simulada para transações educacionais de cripto
  • Protocolo MCP oficial para integração com agentes de IA
  • Stack web moderna para uma UX bonita
┌─────────────┐  ┌─────────────┐  ┌─────────────┐
│ 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)     │
└──────────────┘      └─────────────────┘

📖 Arquitetura Detalhada: Veja ARCHITECTURE.md para:

  • Diagramas de componentes
  • Exemplos de código
  • Divisão entre real e simulado
  • Comparação com Base MCP e x402
  • Mergulho técnico profundo

Componentes Principais

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

Expõe 13 ferramentas através do Model Context Protocol:

Ferramentas de Dados de Mercado (8):

  • Preços em tempo real, dados históricos, estatísticas de mercado
  • Busca e detalhes de ativos, taxas de câmbio
  • Análise técnica (volatilidade, tendências, suporte/resistência)

Ferramentas de Transação (5):

  • 🍺₿ Calculadora de cerveja para cripto
  • Simulação de carteira virtual (USD → Cripto)
  • Economia circular (Cripto → Cerveja!)
  • Saldo e histórico de transações

Aplicação Frontend

Aplicação React moderna com:

  • Chat de IA - Alimentado por GPT-4 com entrada de voz 🎤 e TTS 🔊
  • Carteira Virtual - Compras de cripto de demonstração e economia de cerveja 🍺₿
  • Explorador de API - Documentação e testes interativos
  • Tutorial - Guia passo a passo de integração MCP
  • Apresentações - Visualizador de slides de negócios

🔧 Configuração

Variáveis de Ambiente

Crie arquivos .env para funcionalidade de chat com IA:

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

Nota de Segurança: O frontend inclui avisos integrados sobre o uso de chaves de API no lado do cliente e só ativa recursos de IA em modo de desenvolvimento.

🤖 Configuração de Chat IA e Recursos de Voz (Opcional)

Para habilitar a interface de chat com IA e recursos de voz:

  1. Obtenha uma Chave de API da OpenAI: Visite Plataforma OpenAI
  2. Crie o arquivo frontend/.env: 
    VITE_OPENAI_API_KEY=sk-your-actual-api-key-here
  3. Reinicie o frontend: O chat usará GPT-4 para discussões inteligentes sobre cripto!

🎤 Recursos de Voz (Requer Chave de API da OpenAI)

Uma vez configurado, você terá acesso a:

  • 🌐 Entrada de Voz Multilíngue - Fale perguntas em qualquer idioma usando OpenAI Whisper

    • Suporta mais de 50 idiomas, incluindo inglês, espanhol, francês, alemão, russo, chinês, japonês e mais
    • Transcrição de fala para texto em tempo real
    • Clique no botão roxo do microfone para começar a gravar

  • 🔊 Respostas de Texto para Fala - Ouça as respostas da IA lidas em voz alta

    • Clique no ícone de alto-falante em qualquer mensagem do assistente
    • Vozes com som natural alimentadas por OpenAI TTS
    • Múltiplas opções de voz disponíveis

  • ⚡ Modo de Fallback - Sem a chave da OpenAI, a API básica Web Speech fornece entrada de voz apenas em inglês

Nota: Sem a chave de API, a interface de chat fornece uma mensagem de configuração útil e funcionalidade básica.

📚 Exemplos de Uso

Ferramentas MCP no 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

Aplicação Web Frontend

  • Visite: http://localhost:3005
  • Chat: Conversas persistentes com gerenciamento de sessões
  • Chat por Voz: Clique no microfone para fazer perguntas por voz em qualquer idioma
  • Ouça as Respostas: Clique no ícone de alto-falante nas mensagens para ouvi-las em voz alta
  • Explorador de API: Teste todas as 8 ferramentas MCP interativamente
  • Dashboard: Visão geral do mercado em tempo real
  • Mercados: Estatísticas detalhadas de negociação

Uso Direto da 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

🛠️ Desenvolvimento

Recursos Principais Implementados

  • ✅ Servidor MCP - 13 ferramentas, conformidade total com o protocolo
  • ✅ Integração com Cursor - Configuração MCP pré-configurada
  • ✅ Economia Circular 🍺₿ - Simulação completa USD→Cripto→Cerveja
  • ✅ Interface de Voz 🎤 - Entrada multilíngue via Whisper
  • ✅ Texto para Fala 🔊 - Respostas da IA lidas em voz alta
  • ✅ Carteira Virtual - Compras de cripto de demonstração e inventário
  • ✅ Sessões de Chat - Conversas persistentes com localStorage
  • ✅ Explorador de API - Documentação interativa para todas as ferramentas
  • ✅ Gerenciamento de Sessões - Crie, alterne, exclua sessões de chat
  • ✅ Integração de IA - Conversas alimentadas por GPT-4 com orquestração de ferramentas
  • ✅ UI de Transações - Recibos bonitos e feedback visual
  • ✅ Segurança - Limitação de taxa, validação, tratamento de erros

Scripts de Desenvolvimento

# 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

Estrutura do Projeto

  • mcp-server/: Servidor MCP TypeScript com 13 ferramentas (8 dados de mercado + 5 carteira)
  • api-server/: Servidor de API REST Express.js com simulação de carteira
  • frontend/: React + TypeScript com TailwindCSS, recursos de voz, UI de carteira
  • docs/: Documentação abrangente (ARCHITECTURE.md, guias, etc.)
  • .cursor/: Configuração MCP do Cursor IDE

📖 Documentação

Documentação Principal

  • README.md - Este arquivo! Visão geral do projeto e início rápido
  • ARCHITECTURE.md 🏗️ - Guia completo de arquitetura técnica
    • Diagramas de sistema e divisão de componentes
    • Componentes reais vs. simulados explicados
    • Exemplos de código e fluxo de dados
    • Comparação com Base MCP e x402
    • Mergulho profundo na stack de tecnologia

Guias de Recursos

  • DEMO_TRANSACTIONS.md 🍺₿ - Referência das ferramentas de transação

    • Todas as 5 ferramentas de carteira explicadas
    • Exemplos de uso e cenários
    • Referência de API

  • CIRCULAR_ECONOMY.md 🔄 - Guia completo da economia

    • Fluxo USD → Cripto → Cerveja
    • Sugestões inteligentes quando o saldo é insuficiente
    • Rastreamento de inventário
    • Desafios e cenários divertidos

  • CHAT_WALLET_INTEGRATION.md 💬 - Integração de chat

    • Uso de ferramentas de carteira em conversas
    • Recibos de transação visuais
    • Exemplos de conversas

Configuração e Instalação

Documentos Interativos

✨ Atualizações Recentes

🍺₿ Economia Circular (Mais Recente!)

  • Compre cerveja virtual COM criptomoeda! - Fluxo completo USD→Cripto→Cerveja
  • Orientação inteligente de IA - Sugere comprar cripto se o saldo for insuficiente
  • Rastreamento de inventário - Veja sua coleção de cervejas na carteira
  • Recibos de transação - Feedback visual bonito no chat
  • 13 ferramentas MCP no total - 8 dados de mercado + 5 ferramentas de transação

🎤 Recursos de Voz e IA

  • Entrada de voz multilíngue - Fale perguntas em mais de 50 idiomas (OpenAI Whisper)
  • Texto para fala - Ouça as respostas da IA lidas em voz alta (OpenAI TTS)
  • Integração GPT-4 - Conversas inteligentes com orquestração de ferramentas
  • Indicadores visuais de ferramentas - Veja quais ferramentas MCP foram usadas

💰 Sistema de Carteira Virtual

  • Transações de demonstração - Simulação segura de compra de cripto
  • Calculadora de cerveja - Maneira divertida de entender o valor do cripto
  • Preços em tempo real - Usa dados ao vivo da Coinbase
  • Histórico de transações - Acompanhe todas as compras
  • Visualização de portfólio - Veja todos os saldos em um só lugar

Gerenciamento de Sessões de Chat

  • Sessões de chat persistentes entre abas do navegador
  • Histórico de sessões com título automático
  • Alternância de sessões em tempo real
  • Persistência baseada em localStorage
  • Padrão Observer para atualizações ao vivo

Explorador de API

  • Testes interativos para todas as 8 ferramentas MCP
  • Respostas de API em tempo real
  • Geração de código (cURL, JavaScript)
  • Funcionalidade de copiar para a área de transferência
  • Documentação abrangente de parâmetros

Integração com Cursor MCP

  • .cursor/mcp.json pré-configurado
  • Carregamento automático de 8 ferramentas MCP
  • Consultas de criptomoedas prontas para uso
  • Fluxo de trabalho profissional de desenvolvimento

🤝 Contribuindo

Aceitamos contribuições! Consulte nosso Guia de Contribuição para detalhes.

  1. Faça um fork do repositório
  2. Crie sua branch de funcionalidade (git checkout -b feature/amazing-feature)
  3. Faça commit das suas alterações (git commit -m 'Add amazing feature')
  4. Envie para a branch (git push origin feature/amazing-feature)
  5. Abra um Pull Request

📋 Roadmap

  • v1.0: Servidor MCP principal com 8 ferramentas
  • v1.1: Persistência de sessões de chat
  • v1.2: Explorador de API interativo
  • v1.3: Integração com Cursor IDE
  • v1.4: Streaming em tempo real via WebSocket
  • v1.5: Gráficos avançados e indicadores técnicos
  • v2.0: Suporte a múltiplas exchanges

🐛 Problemas Conhecidos

  • Limite de taxa na API pública da Coinbase (60 requisições/hora para alguns endpoints)
  • Sessões de chat limitadas ao localStorage (máximo de 10 sessões por desempenho)
  • Chaves de API no lado do cliente devem ser usadas apenas em desenvolvimento

📄 Licença

Este projeto está licenciado sob a Licença MIT - consulte o arquivo LICENSE para detalhes.

🙏 Agradecimentos

  • Equipe do Model Context Protocol pela excelente especificação
  • Coinbase por fornecer APIs públicas robustas
  • Cursor pela excelente integração com MCP
  • A comunidade de código aberto pelas ferramentas e bibliotecas inestimáveis

📞 Suporte

Feito com ❤️ por Vladimir Bichev para as comunidades de criptomoedas e IA