Skip to main content
Glama

🚀 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

  • 🚦 Надежная обработка ошибок : понятные сообщения об ошибках с соответствующими кодами состояния

  • 🧩 Простое развертывание : минимальная конфигурация с пошаговым процессом настройки

  • 📘 Обширная документация : понятные инструкции по использованию и примеры

🚀 Быстрый старт

# Option 1: Install and run with npx npx coingecko-api-server # Option 2: Clone and install manually git clone https://github.com/yourusername/coingecko-api-server.git cd coingecko-api-server npm install npm run setup npm start

📦 Установка

Вариант 1: Использование npx (рекомендуется)

Самый быстрый способ начать:

npx coingecko-api-server

Это позволит:

  1. 📥 Скачайте и установите сервер

  2. 🧰 Запустите интерактивный мастер настройки

  3. 🔑 Запросите ваш ключ API CoinGecko (необязательно)

  4. 🚀 Запустить сервер автоматически

Вариант 2: Ручная установка

Для большего контроля над процессом установки:

# Clone the repository git clone https://github.com/yourusername/coingecko-api-server.git cd coingecko-api-server # Install dependencies npm install # Run the setup script npm run setup # Start the server npm start

⚙️ Конфигурация

Сервер настраивается с помощью переменных среды в файле .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 - Получить трендовые монеты

Примеры

Получить цену биткоина в долларах США:

curl "http://localhost:3000/api/simple/price?ids=bitcoin&vs_currencies=usd"

Ответ:

{ "bitcoin": { "usd": 45678.12 } }

Получите топ-5 криптовалют по рыночной капитализации:

curl "http://localhost:3000/api/coins/markets?vs_currency=usd&order=market_cap_desc&per_page=5&page=1"

🤖 Интеграция ИИ (MCP)

Этот сервер реализует протокол Marketplace Component Program (MCP), позволяющий системам искусственного интеллекта, таким как Claude, получать доступ к данным криптовалюты.

Точки интеграции MCP

  1. Конечная точка JSON-RPC : /rpc — обрабатывает вызовы методов от клиентов ИИ.

  2. Определение схемы : /mcp/schema — определяет доступные инструменты и параметры.

Доступные методы MCP

  • ping — проверка статуса API

  • getPrice — Получить данные о ценах для указанных криптовалют

  • 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

Отсутствующие данные

Проверьте параметры в вашем запросе

🧪 Развитие

# Run in development mode with hot reload npm run dev # Run tests npm test # Build for production npm run build

🔄 Как это работает

Сервер выступает в качестве промежуточного программного обеспечения между вашими приложениями и API CoinGecko:

  1. Маршрутизация запросов : обрабатывает входящие запросы от клиентов RESTful и JSON-RPC.

  2. Выбор API : выбор между бесплатным и профессиональным API на основе конфигурации

  3. Управление ограничением скорости : реализует интеллектуальное регулирование запросов.

  4. Обработка ответа : форматирует и возвращает данные в согласованной структуре.

  5. Обработка ошибок : предоставляет подробную информацию об ошибках для устранения неполадок.

📱 Варианты использования

  • Финансовые консультанты на базе искусственного интеллекта : дайте возможность системам искусственного интеллекта получать доступ к данным криптовалюты в режиме реального времени

  • Инвестиционные панели : создавайте панели управления криптовалютой с надежным доступом к данным

  • Трекеры портфеля : создание приложений для мониторинга криптовалютных активов

  • Инструменты анализа рынка : разработка инструментов для технического и фундаментального анализа.

  • Торговые боты : используйте автоматизированные торговые системы с рыночными данными

📄 Лицензия

Данный проект лицензирован по лицензии MIT — подробности см. в файле LICENSE .

🙏 Благодарности

  • CoinGecko для комплексного API данных криптовалюты

  • Антропный для Claude AI и программы MCP

  • Сообществу разработчиков ПО с открытым исходным кодом за их неоценимый вклад


⬆ Вернуться наверх

-
security - not tested
A
license - permissive license
-
quality - not tested

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/BlindVibeDev/CoinGeckoMCP'

If you have feedback or need assistance with the MCP directory API, please join our Discord server