🚀 CoinGecko API Сервер MCP
Бесперебойный доступ к данным криптовалюты для систем и приложений ИИ
Возможности • Быстрый старт • Установка • Конфигурация • Справочник API • Интеграция MCP • Профессиональный API • Устранение неполадок • Лицензия
🌟 Обзор
CoinGecko API Server MCP — это мощное, готовое к производству решение Node.js, которое обеспечивает бесперебойный доступ к данным рынка криптовалют через элегантный интерфейс RESTful API и MCP (Marketplace Component Program). Он связывает системы ИИ, такие как Claude, с криптографическими данными в реальном времени, одновременно обрабатывая все сложности ограничений скорости API, откатов и обработки ошибок.
✨ Основные характеристики
- 🔄 Поддержка двух API : легко интегрируется с API CoinGecko Free и Pro
- 🧠 Интеграция ИИ : Полная реализация протокола MCP для помощников ИИ
- 🛡️ Интеллектуальный откат : автоматическое переключение между API для предотвращения ограничения скорости
- ⚡ Оптимизированная производительность : эффективная обработка запросов и кэширование ответов
- 📊 Комплексные данные : доступ ко всем основным показателям криптовалюты
- 🔌 Простой интерфейс : интуитивно понятные конечные точки RESTful и методы JSON-RPC
- 🚦 Надежная обработка ошибок : понятные сообщения об ошибках с соответствующими кодами состояния
- 🧩 Простое развертывание : минимальная конфигурация с пошаговым процессом настройки
- 📘 Обширная документация : понятные инструкции по использованию и примеры
🚀 Быстрый старт
📦 Установка
Вариант 1: Использование npx (рекомендуется)
Самый быстрый способ начать:
Это позволит:
- 📥 Скачайте и установите сервер
- 🧰 Запустите интерактивный мастер настройки
- 🔑 Запросите ваш ключ API CoinGecko (необязательно)
- 🚀 Запустить сервер автоматически
Вариант 2: Ручная установка
Для большего контроля над процессом установки:
⚙️ Конфигурация
Сервер настраивается с помощью переменных среды в файле .env
:
Переменная | Описание | По умолчанию |
---|---|---|
PORT | Порт сервера | 3000 |
COINGECKO_API_KEY | API-ключ CoinGecko Pro (необязательно) | - |
CACHE_DURATION | Продолжительность кэширования в секундах | 60 |
LOG_LEVEL | Уровень ведения журнала (ошибка, предупреждение, информация, отладка) | info |
📚 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
- Сообществу разработчиков ПО с открытым исходным кодом за их неоценимый вклад
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Мощный и гибкий сервер Node.js Express, который предоставляет комплексный интерфейс для API данных криптовалюты CoinGecko. Этот сервер поддерживает как бесплатный публичный API, так и Pro API с автоматическим откатом.
- 🌟 Обзор
- ✨ Основные характеристики
- 🚀 Быстрый старт
- 📦 Установка
- ⚙️ Конфигурация
- 📚 API-ссылка
- 🤖 Интеграция ИИ (MCP)
- 💎 Преимущества Pro API
- 🔧 Устранение неполадок
- 🧪 Развитие
- 🔄 Как это работает
- 📱 Варианты использования
- 📄 Лицензия
- 🙏 Благодарности
Related Resources
Related MCP Servers
- -securityFlicense-qualityA Model Context Protocol server built with Express.js that provides cryptographic tools including key pair generation, shared secret derivation, and message encryption/decryption.Last updated -160JavaScript
- -securityAlicense-qualityA Node.js Express server that provides access to CoinGecko's cryptocurrency data through a comprehensive API interface, supporting both free and Pro APIs with automatic fallback functionality.Last updated -1JavaScriptMIT License
- -securityAlicense-qualityProvides cryptocurrency market data using the CoinGecko APILast updated -1PythonMIT License
- -security-license-qualityA server that provides real-time cryptocurrency data through the Model Context Protocol, allowing access to detailed exchange information and current cryptocurrency rates from the CoinCap API.Last updated -1TypeScriptMIT License