CoinCap MCP Server

MCP сервер для получения данных о курсах криптовалют через CoinCap API v3.

Возможности

Сервер предоставляет следующие инструменты:

• get_assets - получить список криптовалют с текущими ценами и рыночными данными
• get_asset_by_id - получить детальную информацию о конкретной криптовалюте
• get_rates - получить курсы обмена для различных валют
• get_rate_by_id - получить курс обмена для конкретной валюты
• get_markets - получить данные о рынках для конкретной криптовалюты

Установка

1. Убедитесь, что у вас установлен Node.js (версия 18 или выше)

2. Установите зависимости:

npm install

3. (Опционально) Получите API ключ CoinCap:
   • Зарегистрируйтесь на https://pro.coincap.io/
   • Создайте API ключ
   • Создайте файл .env в корне проекта:

   cp .env.example .env
   

   • Добавьте ваш API ключ в файл .env:

   COINCAP_API_KEY=ваш_api_ключ
   

Примечание: API ключ обязателен для работы с CoinCap API v3. Зарегистрируйтесь на https://pro.coincap.io/ и создайте API ключ для доступа к API.

Локальный запуск

Для тестирования сервера локально:

npm start

Настройка в Claude Desktop

Чтобы использовать этот MCP сервер с Claude Desktop, добавьте следующую конфигурацию в файл настроек Claude:

macOS

Файл: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows

Файл: %APPDATA%\Claude\claude_desktop_config.json

Конфигурация

{
  "mcpServers": {
    "coincap": {
      "command": "node",
      "args": ["/Users/aleksandrvasilev/McpServer/index.js"]
    }
  }
}

Замените путь /Users/aleksandrvasilev/McpServer/index.js на абсолютный путь к файлу index.js на вашей системе.

Примеры использования

После подключения MCP сервера к Claude Desktop, вы можете использовать следующие запросы:

• "Какой сейчас курс биткоина?"
• "Покажи топ-10 криптовалют по капитализации"
• "Какой курс эфириума?"
• "Покажи информацию о Cardano"
• "Какие биржи торгуют биткоином?"

API Endpoints

Сервер использует CoinCap API v3:

• Base URL: https://rest.coincap.io/v3
• Документация: https://docs.coincap.io

Примечания

• Важно: CoinCap API v3 требует обязательную авторизацию через API ключ
• API использует систему кредитов для тарификации запросов
• Зарегистрируйтесь на https://pro.coincap.io/ для получения API ключа
• Доступны различные тарифные планы (Demo, Basic, Growth, Professional, Enterprise)

Устранение неполадок

Ошибки авторизации

Если вы получаете ошибки авторизации:

1. Убедитесь, что API ключ установлен:

   • Проверьте наличие файла .env с переменной COINCAP_API_KEY
   • Убедитесь, что ключ правильный и активен
   • Перезапустите Claude Desktop после изменения .env

2. Проверьте лимиты API:

   • API v3 использует систему кредитов
   • Убедитесь, что у вас достаточно кредитов на вашем тарифном плане
   • Проверьте лимиты запросов в минуту

3. Проверьте сетевое подключение:

   • Убедитесь, что нет корпоративного прокси/файрвола
   • Проверьте, что https://rest.coincap.io доступен

Лицензия

MIT