Skip to main content
Glama

CoinGecko

🚀 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
  • 🚦 Надежная обработка ошибок : понятные сообщения об ошибках с соответствующими кодами состояния
  • 🧩 Простое развертывание : минимальная конфигурация с пошаговым процессом настройки
  • 📘 Обширная документация : понятные инструкции по использованию и примеры

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

# 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_KEYAPI-ключ 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

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 с автоматическим откатом.

  1. 🌟 Обзор
    1. ✨ Основные характеристики
      1. 🚀 Быстрый старт
        1. 📦 Установка
          1. Вариант 1: Использование npx (рекомендуется)
          2. Вариант 2: Ручная установка
        2. ⚙️ Конфигурация
          1. 📚 API-ссылка
            1. Конечные точки RESTful
            2. Примеры
          2. 🤖 Интеграция ИИ (MCP)
            1. Точки интеграции MCP
            2. Доступные методы MCP
          3. 💎 Преимущества Pro API
            1. 🔧 Устранение неполадок
              1. 🧪 Развитие
                1. 🔄 Как это работает
                  1. 📱 Варианты использования
                    1. 📄 Лицензия
                      1. 🙏 Благодарности

                        Related MCP Servers

                        • -
                          security
                          F
                          license
                          -
                          quality
                          A 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 -
                          160
                          JavaScript
                        • -
                          security
                          A
                          license
                          -
                          quality
                          A 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 -
                          1
                          JavaScript
                          MIT License
                        • -
                          security
                          -
                          license
                          -
                          quality
                          A 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 -
                          1
                          TypeScript
                          MIT License

                        View all related MCP servers

                        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