CoinCap MCP Server

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

Возможности

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

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

Установка

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

npm install

(Опционально) Получите 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)

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

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

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

Убедитесь, что API ключ установлен:
- Проверьте наличие файла .env с переменной COINCAP_API_KEY
- Убедитесь, что ключ правильный и активен
- Перезапустите Claude Desktop после изменения .env
Проверьте лимиты API:
- API v3 использует систему кредитов
- Убедитесь, что у вас достаточно кредитов на вашем тарифном плане
- Проверьте лимиты запросов в минуту
Проверьте сетевое подключение:
- Убедитесь, что нет корпоративного прокси/файрвола
- Проверьте, что https://rest.coincap.io доступен

Лицензия

MIT