Coin MCP Server

Coin MCP Server

Um servidor Model Context Protocol que fornece acesso aos dados de criptomoedas da CoinMarketCap. Este servidor permite que aplicações com inteligência artificial recuperem listagens, cotações e informações detalhadas sobre diversas moedas.

Ferramentas Disponíveis

• listing-coins - Busca uma lista paginada de todas as criptomoedas ativas com os dados de mercado mais recentes.

  • start (inteiro, opcional): Deslocamento do início (índice baseado em 1) da lista paginada de itens a retornar.
  • limit (inteiro, opcional): Número de resultados a retornar (padrão: 10, máximo: 5000).
  • price_min (número, opcional): Preço mínimo em USD para filtrar resultados.
  • price_max (número, opcional): Preço máximo em USD para filtrar resultados.
  • market_cap_min (número, opcional): Capitalização de mercado mínima para filtrar resultados.
  • market_cap_max (número, opcional): Capitalização de mercado máxima para filtrar resultados.
  • convert (string, opcional): Calcula cotações de mercado em múltiplas moedas.
  • sort (string, opcional): Campo para ordenar a lista de criptomoedas.
  • sort_dir (string, opcional): Direção para ordenar criptomoedas (asc ou desc).

• get-coin-info - Recupera informações detalhadas sobre uma criptomoeda específica.

  • id (string, opcional): Um ou mais IDs de criptomoedas da CoinMarketCap separados por vírgula.
  • slug (string, opcional): Uma lista de slugs de criptomoedas separados por vírgula.
  • symbol (string, opcional): Um ou mais símbolos de criptomoedas separados por vírgula.

• get-coin-quotes - Busca as cotações de mercado mais recentes para uma ou mais criptomoedas.

  • id (string, opcional): Um ou mais IDs de criptomoedas da CoinMarketCap separados por vírgula.
  • slug (string, opcional): Uma lista de slugs de criptomoedas separados por vírgula.
  • symbol (string, opcional): Um ou mais símbolos de criptomoedas separados por vírgula.

Instalação

Instalando via Smithery

Para instalar automaticamente o Cryptocurrency Data para Claude Desktop via Smithery:

npx -y @smithery/cli install coin-api-mcp --client claude

Compilar o Servidor

Clone este repositório e compile e instale o programa com seu interpretador Python padrão (recomendado).

git clone https://github.com/longmans/coin_api_mcp.git
cd coin_api_mcp
uv build
uv pip install .

Após a instalação, você pode executá-lo como um script usando:

python -m coin_api_mcp

Configuração

Chave de API

O servidor requer uma chave de API da CoinMarketCap para funcionar. Você pode obter uma no site da CoinMarketCap. A chave de API pode ser fornecida de duas maneiras:

1. Como uma variável de ambiente:

export COINMARKETCAP_API_KEY=your_api_key_here

2. Como um argumento de linha de comando:

python -m coin_api_mcp --api-key=your_api_key_here

Configurar para Claude.app

Adicione às suas configurações do Claude:

"mcpServers": {
  "coin_api": {
    "command": "python",
    "args": ["-m", "coin_api_mcp"]
  },
  "env": {
        "COINMARKETCAP_API_KEY": "your_api_key_here"
  }
}

Se você encontrar algum problema, talvez seja necessário usar o caminho completo do interpretador Python que está usando. Você pode executar um which python para descobrir o caminho exato, se necessário.

Lembre-se de definir a variável de ambiente COINMARKETCAP_API_KEY ou fornecê-la via o argumento --api-key.

Depuração

Você pode usar o inspetor MCP para depurar o servidor

Contribuindo

Incentivamos contribuições para ajudar a expandir e melhorar o Coin MCP Server. Se você deseja adicionar novos recursos de busca, aprimorar funcionalidades existentes ou melhorar a documentação, sua contribuição é valiosa.

Para exemplos de outros servidores MCP e padrões de implementação, consulte: https://github.com/modelcontextprotocol/servers

Pull requests são bem-vindos! Sinta-se à vontade para contribuir com novas ideias, correções de bugs ou melhorias para tornar o Coin MCP Server ainda mais poderoso e útil.

Licença

O Coin MCP Server é licenciado sob a Licença MIT. Isso significa que você é livre para usar, modificar e distribuir o software, sujeito aos termos e condições da Licença MIT. Para mais detalhes, consulte o arquivo LICENSE no repositório do projeto.