# 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. Установите зависимости:
```bash
npm install
```
3. **(Опционально)** Получите API ключ CoinCap:
- Зарегистрируйтесь на https://pro.coincap.io/
- Создайте API ключ
- Создайте файл `.env` в корне проекта:
```bash
cp .env.example .env
```
- Добавьте ваш API ключ в файл `.env`:
```
COINCAP_API_KEY=ваш_api_ключ
```
**Примечание:** API ключ обязателен для работы с CoinCap API v3. Зарегистрируйтесь на https://pro.coincap.io/ и создайте API ключ для доступа к API.
## Локальный запуск
Для тестирования сервера локально:
```bash
npm start
```
## Настройка в Claude Desktop
Чтобы использовать этот MCP сервер с Claude Desktop, добавьте следующую конфигурацию в файл настроек Claude:
### macOS
Файл: `~/Library/Application Support/Claude/claude_desktop_config.json`
### Windows
Файл: `%APPDATA%\Claude\claude_desktop_config.json`
### Конфигурация
```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
