ALAPI

oficial

Herramientas MCP de ALAPI, llama a cientos de interfaces API a través de MCP

GitHub
12

¿Qué puedes hacer con ALAPI MCP?

  • Consultas de IP y dominio — Solicita información de geolocalización y detalles del ISP de cualquier dirección IPv4 o IPv6 mediante ip_query.
  • Informes meteorológicos — Obtén condiciones actuales, alertas, AQI y pronósticos para ciudades chinas a través de weather_query.
  • Listas de tendencias — Consulta temas de tendencia en tiempo real de Weibo, Douyin, Toutiao, Zhihu, Baidu y 36Kr.
  • Verificación de empresas — Busca detalles de registro comercial chino por nombre de empresa o código de crédito social unificado.
  • Seguimiento de paquetes — Rastrea el estado de envíos a través de ZTO, STO, SF Express, J&T, Best, YTO y otros transportistas.
  • Moderación de contenido — Revisa textos en busca de infracciones de políticas, adecuado para flujos de revisión de salida de IA.

Documentación

🔥 Servidor MCP ALAPI

smithery badge License

Esta es una implementación de servidor MCP (Model Context Protocol) basada en ALAPI, que permite invocar directamente las interfaces de ALAPI a través del protocolo MCP, integrando fácilmente los ricos recursos API de ALAPI en diversas aplicaciones de IA compatibles con MCP.

✨ Características

  • 🔍 Amplia variedad de recursos API - Proporciona más de 100 servicios API comunes, como consulta de IP, consulta del clima, listas de tendencias, información empresarial, etc.
  • 🧩 Soporte del protocolo MCP - Totalmente compatible con Model Context Protocol, se integra fácilmente en diversas aplicaciones de IA.
  • 🔄 Carga automática - Carga automáticamente la especificación OpenAPI de ALAPI, sin necesidad de configuración manual.
  • 🎯 Invocación flexible - Permite cargar todas las APIs o solo las especificadas, para usar bajo demanda (análisis de videos cortos, consulta del clima, lectura diaria del mundo en 60 segundos, consulta de empresas, etc.).
  • 🛡️ Respuesta unificada - Proporciona un manejo de errores y formato de respuesta unificados, simplificando el flujo de desarrollo.
  • ⚙️ Configurabilidad - Soporta configuración mediante variables de entorno, adaptándose fácilmente a diferentes escenarios de uso.

📖 Guía de uso

Primero debe comprender el protocolo MCP y luego agregar el servicio ALAPI MCP según la siguiente configuración.

Uso en clientes MCP

ALAPI MCP Server está diseñado para usarse con clientes que soporten el protocolo MCP y no admite una configuración independiente por línea de comandos. Siga estos pasos para configurarlo en su cliente MCP:

Método 1: MCP remoto

Este proyecto admite el despliegue con un clic en la plataforma de desarrollo en la nube de Tencent, proporcionando acceso remoto SSE.

☁️ Ir a la plataforma de desarrollo en la nube para desplegar MCP Server

Método 2: Instalación automática con Smithery

Instale ALAPI MCP Server a través de Smithery, adecuado para el cliente Claude Desktop:

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

Método 3: Usar directamente el binario precompilado (recomendado, no requiere instalar dependencias)

  1. Visite la página de Releases para descargar la última versión.

    Dirección de descarga acelerada en China: https://cnb.cool/alapi/mcp-alapi-cn/-/releases

  2. Seleccione la última versión correspondiente a su sistema operativo:

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

  3. Configure en un cliente compatible con MCP (como Claude Desktop):

    • Abra la configuración del cliente MCP.
    • Agregue un nuevo servidor MCP.
    • Especifique la ruta del archivo binario descargado.
    • Configure las variables de entorno necesarias (como ALAPI_TOKEN).

Configurar variables de entorno

ALAPI_TOKEN - Token de acceso a la plataforma ALAPI (obligatorio)

Debe configurarse con el TOKEN que creó en la plataforma ALAPI, para la autenticación de la interfaz.

Ejemplo de configuración del cliente MCP

En Claude Desktop u otros clientes compatibles con MCP, puede consultar la siguiente configuración:

Configuración JSON (usando el archivo binario local)

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

Clientes MCP compatibles

Según la documentación de MCP, los siguientes clientes admiten la integración de herramientas MCP:

  • Claude Desktop App
  • Claude Code
  • Cursor
  • Continue
  • Cline
  • Y otros clientes que soporten el protocolo MCP.

Nota: Asegúrese de que su cliente MCP admita la función de integración de herramientas. Consulte la documentación específica de cada cliente para la configuración.

🛠️ Funciones compatibles

A continuación se muestran algunas de las funciones compatibles. Para conocer la lista completa, consulte la invocación real:

Nombre de la funciónDescripción
Consulta de IPConsulta la información de geolocalización de una IP, compatible con IPv4 e IPv6.
Consulta del climaConsulta detalles del clima en China, incluyendo información meteorológica, alertas, índices, AQI, etc.
Tendencias del díaConsulta datos de las listas de tendencias del día, incluyendo tendencias de Douyin, Toutiao, Zhihu, 36kr, Baidu, Weibo, etc.
Moderación de textoConsulta si un texto infringe las normas, especialmente adecuado para la moderación de contenido de IA.
Acortador de URLsAcorta URLs largas en enlaces cortos, facilitando el envío de SMS, generación de códigos QR, etc.
Reconocimiento de códigos QRAdmite múltiples códigos en una imagen, códigos QR, códigos de barras, etc.
Hoy en la historiaConsulta eventos importantes ocurridos en una fecha específica del pasado.
Consulta de tipo de cambioConsulta el tipo de cambio y la conversión de monedas según el código de moneda, compatible con más de 170 países y regiones.
Consulta de empresasConsulta información básica de registro empresarial por nombre o código unificado de crédito social.
Consulta de envíosConsulta gratuita del seguimiento de paquetes, compatible con ZTO, STO, SF, J&T, Best, YTO, etc.
HoróscopoProporciona servicios de consulta del horóscopo para los doce signos del zodiaco: hoy, mañana, esta semana, este mes o este año.
Precio del oroConsulta el precio actual del oro en tiempo real, máximo, mínimo y precios de marcas.

🔗 Enlaces relacionados

🙏 Agradecimientos