Coinmarket MCP server

Coinmarket MCP server

Coinmarket MCP Server

Componentes

Recursos

O servidor implementa alguns endpoints da Coinmarket API

• Esquema de URI personalizado coinmarket:// para acessar notas individuais
• Cada recurso de nota possui um nome, descrição e tipo MIME text/plain

Ferramentas

O servidor implementa duas ferramentas:

• get-currency-listings: Obter as listagens de moedas mais recentes
• get-quotes: Obter cotações para tokens
  • Aceita "slug" (exemplo: bitcoin) ou "symbol" (exemplo: BTC) como argumento opcional de string

Configuração

Requer chave de API da Coinmarket.

Início rápido

Pré-requisitos

• Python 3.12 ou superior
• Gerenciador de pacotes uv

Instalação

Instale o uv se ainda não o fez:

# macOS and Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

Claude Desktop

No MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json No Windows: %APPDATA%/Claude/claude_desktop_config.json

Configuração de Servidores Não Publicados em Desenvolvimento

``` "mcpServers": { "coinmarket_service": { "command": "uv", "args": [ "--directory", "/path/to/coinmarket_service", "run", "coinmarket_service" ], "env": { "COINMARKET_API_KEY": "" } } } ```

Docker

Você também pode executar o servidor usando Docker:

# Build the image
docker build -t coinmarket-service .

# Run the container
docker run -e COINMARKET_API_KEY=your_api_key_here coinmarket-service

Para configuração do Claude Desktop com Docker:

"mcpServers": {
  "coinmarket_service": {
    "command": "docker",
    "args": [
      "run",
      "--rm",
      "-e",
      "COINMARKET_API_KEY=<insert api key>",
      "coinmarket-service"
    ]
  }
}

Solução de problemas

Erro "spawn uv ENOENT"

Se você vir este erro, significa que uv não está instalado ou não está no seu PATH:

1. Instale o uv seguindo as instruções acima
2. Reinicie seu terminal/Claude Desktop após a instalação
3. Verifique a instalação: Execute uv --version no terminal
4. Atualize o PATH: Certifique-se de que o uv esteja no PATH do seu sistema

Problemas de configuração

• Substitua /path/to/coinmarket_service pelo caminho real do seu repositório clonado
• Certifique-se de que seu COINMARKET_API_KEY seja válido
• O caminho deve apontar para o diretório raiz que contém pyproject.toml