ALAPI

официальный

Инструменты MCP ALAPI, вызывайте сотни API-интерфейсов через MCP

GitHub
12

Что можно делать с ALAPI MCP?

  • IP и поиск доменов — Запрос геолокации и данных интернет-провайдера для любого IPv4 или IPv6 адреса с помощью ip_query.
  • Прогнозы погоды — Получение текущих условий, оповещений, AQI и прогнозов для китайских городов через weather_query.
  • Горячие тренды — Загрузка актуальных тем из Weibo, Douyin, Toutiao, Zhihu, Baidu и 36Kr в реальном времени.
  • Проверка компаний — Поиск данных о регистрации китайских предприятий по названию компании или единому социальному кредитному коду.
  • Отслеживание посылок — Отслеживание статуса доставки через ZTO, STO, SF Express, J&T, Best, YTO и других перевозчиков.
  • Модерация контента — Проверка текста на нарушения политики, подходит для рабочих процессов проверки выводов ИИ.

Документация

🔥 ALAPI MCP Server

smithery badge License

Это реализация MCP (Model Context Protocol) сервера на базе ALAPI, позволяющая напрямую вызывать интерфейсы ALAPI через протокол MCP и легко интегрировать богатые API-ресурсы ALAPI в различные AI-приложения, поддерживающие MCP.

✨ Возможности

  • 🔍 Богатые API-ресурсы — более 100 популярных API-сервисов: IP-запросы, погода, горячие рейтинги, информация о компаниях и многое другое
  • 🧩 Поддержка MCP — полная совместимость с Model Context Protocol, простая интеграция в любые AI-приложения
  • 🔄 Автозагрузка — автоматическая загрузка спецификации ALAPI OpenAPI, ручная настройка не требуется
  • 🎯 Гибкий вызов — поддержка загрузки всех или выбранных API по необходимости (разбор коротких видео, погода, «60 секунд о мире», запросы по компаниям и т.д.)
  • 🛡️ Единый ответ — унифицированная обработка ошибок и формат ответов упрощают процесс разработки
  • ⚙️ Настраиваемость — поддержка конфигурации через переменные окружения, лёгкая адаптация к разным сценариям использования

📖 Руководство по использованию

Сначала ознакомьтесь с протоколом MCP, затем добавьте сервис ALAPI MCP согласно инструкции ниже.

Использование в MCP-клиентах

ALAPI MCP Server спроектирован для работы с клиентами, поддерживающими протокол MCP, и не поддерживает самостоятельную настройку из командной строки. Следуйте инструкциям ниже, чтобы настроить его в вашем MCP-клиенте:

Способ 1: Удалённый MCP

Проект поддерживает развёртывание в один клик на платформе облачной разработки Tencent и предоставляет удалённый доступ по SSE.

☁️ Перейти к развёртыванию MCP Server на платформе облачной разработки

Способ 2: Автоматическая установка через Smithery

Установите ALAPI MCP Server через Smithery для клиента Claude Desktop:

npx -y @smithery/cli install @ALAPI-SDK/mcp-alapi-cn --client claude

Способ 3: Использование готового бинарного файла (рекомендуется, не требует установки зависимостей)

  1. Перейдите на страницу Releases и скачайте последнюю версию

    Зеркало для ускоренной загрузки: https://cnb.cool/alapi/mcp-alapi-cn/-/releases

  2. Выберите последнюю версию для вашей операционной системы:

    • Windows: mcp-alapi-cn.exe
    • macOS: mcp-alapi-cn-macos
    • Linux: mcp-alapi-cn-linux

  3. Настройте в MCP-клиенте (например, Claude Desktop):

    • Откройте настройки MCP-клиента
    • Добавьте новый MCP-сервер
    • Укажите путь к скачанному бинарному файлу
    • Задайте необходимые переменные окружения (например, ALAPI_TOKEN)

Настройка переменных окружения

ALAPI_TOKEN — токен доступа к платформе ALAPI (обязательно)

Необходимо указать TOKEN, созданный вами на платформе ALAPI, для аутентификации запросов.

Пример конфигурации MCP-клиента

В Claude Desktop или других клиентах с поддержкой MCP можно использовать следующую конфигурацию:

JSON-конфигурация (с локальным бинарным файлом)

{
  "mcpServers": {
    "alapi": {
      "path": "/path/to/mcp-alapi-cn",
      "env": {
        "ALAPI_TOKEN": "在 ALAPI 平台申请创建的 token"
      }
    }
  }
}

Поддерживаемые MCP-клиенты

Согласно документации MCP, следующие клиенты поддерживают интеграцию инструментов MCP:

  • Claude Desktop App
  • Claude Code
  • Cursor
  • Continue
  • Cline
  • и другие клиенты, поддерживающие протокол MCP

Примечание: убедитесь, что ваш MCP-клиент поддерживает интеграцию инструментов; для настройки обратитесь к документации конкретного клиента.

🛠️ Поддерживаемые функции

Ниже перечислены некоторые поддерживаемые функции; полный перечень уточняйте при фактическом вызове:

ФункцияОписание
IP-запросОпределение местоположения по IP, поддержка IPv4 и IPv6
ПогодаДетальная информация о погоде по Китаю: сводка, предупреждения, индексы, AQI и т.д.
Горячие рейтинги дняДанные горячих рейтингов: топы Douyin, Toutiao, Zhihu, 36kr, Baidu, Weibo и др.
Проверка текстаПроверка текста на нарушения, особенно полезна для модерации AI-контента
Короткие ссылкиСокращение длинных URL для удобной отправки в SMS, генерации QR-кодов и других сценариев
Распознавание QR-кодовПоддержка нескольких кодов на одном изображении, распознавание двумерных и одномерных штрихкодов
Этот день в историиВажные события, произошедшие в указанную дату в истории
Курсы валютЗапрос курсов и конвертация по кодам валют, поддержка более 170 стран и регионов
Запросы по компаниямБазовая коммерческая информация по названию компании или единому социальному кредитному коду
Отслеживание посылокБесплатное отслеживание логистики: ZTO, STO, SF, J&T, Best, YTO и др.
ГороскопГороскоп на сегодня, завтра, неделю, месяц или год для всех двенадцати знаков зодиака
Цена на золотоТекущая цена золота в реальном времени: максимальная, минимальная, цены брендов

🔗 Ссылки

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