🚀 CoinGecko API Сервер MCP
Бесперебойный доступ к данным криптовалюты для систем и приложений ИИ
Возможности • Быстрый старт • Установка • Конфигурация • Справочник API • Интеграция MCP • Профессиональный API • Устранение неполадок • Лицензия
🌟 Обзор
CoinGecko API Server MCP — это мощное, готовое к производству решение Node.js, которое обеспечивает бесперебойный доступ к данным рынка криптовалют через элегантный интерфейс RESTful API и MCP (Marketplace Component Program). Он связывает системы ИИ, такие как Claude, с криптографическими данными в реальном времени, одновременно обрабатывая все сложности ограничений скорости API, откатов и обработки ошибок.
Related MCP server: CoinGecko API Server MCP
✨ Основные характеристики
🔄 Поддержка двух API : легко интегрируется с API CoinGecko Free и Pro
🧠 Интеграция ИИ : Полная реализация протокола MCP для помощников ИИ
🛡️ Интеллектуальный откат : автоматическое переключение между API для предотвращения ограничения скорости
⚡ Оптимизированная производительность : эффективная обработка запросов и кэширование ответов
📊 Комплексные данные : доступ ко всем основным показателям криптовалюты
🔌 Простой интерфейс : интуитивно понятные конечные точки RESTful и методы JSON-RPC
🚦 Надежная обработка ошибок : понятные сообщения об ошибках с соответствующими кодами состояния
🧩 Простое развертывание : минимальная конфигурация с пошаговым процессом настройки
📘 Обширная документация : понятные инструкции по использованию и примеры
🚀 Быстрый старт
📦 Установка
Вариант 1: Использование npx (рекомендуется)
Самый быстрый способ начать:
Это позволит:
📥 Скачайте и установите сервер
🧰 Запустите интерактивный мастер настройки
🔑 Запросите ваш ключ API CoinGecko (необязательно)
🚀 Запустить сервер автоматически
Вариант 2: Ручная установка
Для большего контроля над процессом установки:
⚙️ Конфигурация
Сервер настраивается с помощью переменных среды в файле .env :
Переменная | Описание | По умолчанию |
| Порт сервера |
|
| API-ключ CoinGecko Pro (необязательно) | - |
| Продолжительность кэширования в секундах |
|
| Уровень ведения журнала (ошибка, предупреждение, информация, отладка) |
|
📚 API-ссылка
Конечные точки RESTful
Базовые конечные точки
GET /api/ping— проверка статуса сервера API
Данные о ценах
GET /api/simple/price- Получить данные о ценах для указанных монетПараметры запроса:
ids,vs_currencies,include_market_cap,include_24hr_vol,include_24hr_change,include_last_updated_at,precision
Данные о монетах
GET /api/coins/markets— Получить рыночные данные для монетПараметры запроса:
vs_currency,ids,category,order,per_page,page,sparkline,price_change_percentage
Рыночные данные
GET /api/global— Получить глобальные данные о криптовалютеGET /api/search/trending- Получить трендовые монеты
Примеры
Получить цену биткоина в долларах США:
Ответ:
Получите топ-5 криптовалют по рыночной капитализации:
🤖 Интеграция ИИ (MCP)
Этот сервер реализует протокол Marketplace Component Program (MCP), позволяющий системам искусственного интеллекта, таким как Claude, получать доступ к данным криптовалюты.
Точки интеграции MCP
Конечная точка JSON-RPC :
/rpc— обрабатывает вызовы методов от клиентов ИИ.Определение схемы :
/mcp/schema— определяет доступные инструменты и параметры.
Доступные методы MCP
ping— проверка статуса APIgetPrice— Получить данные о ценах для указанных криптовалютgetSupportedVsCurrencies— Получить список поддерживаемых валютgetCoinMarkets— Получить рыночные данные для монетgetGlobal— Получите глобальные данные о криптовалютеgetTrending- Получить трендовые монеты
Подробные инструкции по интеграции см. в MCP_INTEGRATION.md .
💎 Преимущества Pro API
Этот сервер поддерживает как CoinGecko Pro API, так и бесплатный API:
Особенность | Бесплатный API | Профессиональный API |
Ограничение скорости | ~30 звонков/минуту | ~500 звонков/минуту |
Регулирование API | Да | Нет |
Поддерживать | Сообщество | Приоритет |
Свежесть данных | 10-30 минут | 1-2 минуты |
Цена | Бесплатно | Подписка |
Более подробную информацию о настройке Pro API см. в USING_COINGECKO_PRO.md .
🔧 Устранение неполадок
Проблема | Решение |
Ошибки ограничения скорости | Рассмотрите возможность обновления до Pro API или измените частоту запросов |
В соединении отказано | Убедитесь, что сервер работает на указанном порту. |
Ошибки аутентификации | Проверьте свой ключ API в файле .env |
Отсутствующие данные | Проверьте параметры в вашем запросе |
🧪 Развитие
🔄 Как это работает
Сервер выступает в качестве промежуточного программного обеспечения между вашими приложениями и API CoinGecko:
Маршрутизация запросов : обрабатывает входящие запросы от клиентов RESTful и JSON-RPC.
Выбор API : выбор между бесплатным и профессиональным API на основе конфигурации
Управление ограничением скорости : реализует интеллектуальное регулирование запросов.
Обработка ответа : форматирует и возвращает данные в согласованной структуре.
Обработка ошибок : предоставляет подробную информацию об ошибках для устранения неполадок.
📱 Варианты использования
Финансовые консультанты на базе искусственного интеллекта : дайте возможность системам искусственного интеллекта получать доступ к данным криптовалюты в режиме реального времени
Инвестиционные панели : создавайте панели управления криптовалютой с надежным доступом к данным
Трекеры портфеля : создание приложений для мониторинга криптовалютных активов
Инструменты анализа рынка : разработка инструментов для технического и фундаментального анализа.
Торговые боты : используйте автоматизированные торговые системы с рыночными данными
📄 Лицензия
Данный проект лицензирован по лицензии MIT — подробности см. в файле LICENSE .
🙏 Благодарности
CoinGecko для комплексного API данных криптовалюты
Антропный для Claude AI и программы MCP
Сообществу разработчиков ПО с открытым исходным кодом за их неоценимый вклад