# 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