🚀 CoinGecko API Сервер MCP

Бесперебойный доступ к данным криптовалюты для систем и приложений ИИ

Возможности • Быстрый старт • Установка • Конфигурация • Справочник API • Интеграция MCP • Профессиональный API • Устранение неполадок • Лицензия

🌟 Обзор

CoinGecko API Server MCP — это мощное, готовое к производству решение Node.js, которое обеспечивает бесперебойный доступ к данным рынка криптовалют через элегантный интерфейс RESTful API и MCP (Marketplace Component Program). Он связывает системы ИИ, такие как Claude, с криптографическими данными в реальном времени, одновременно обрабатывая все сложности ограничений скорости API, откатов и обработки ошибок.

Related MCP server: Crypto Trader MCP Tool

✨ Основные характеристики

• 🔄 Поддержка двух 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 :

📚 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:

Более подробную информацию о настройке Pro API см. в USING_COINGECKO_PRO.md .

🔧 Устранение неполадок

🧪 Развитие

# 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

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

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