ALAPI

oficial

Ferramentas MCP ALAPI, chame centenas de interfaces de API via MCP

GitHub
12

O que você pode fazer com ALAPI MCP?

  • Consultas de IP e domínio — Solicite dados de geolocalização e ISP de qualquer endereço IPv4 ou IPv6 usando ip_query.
  • Previsão do tempo — Obtenha condições atuais, alertas, IQA e previsões para cidades chinesas via weather_query.
  • Listas de tendências — Acesse tópicos em tempo real do Weibo, Douyin, Toutiao, Zhihu, Baidu e 36Kr.
  • Verificação de empresas — Consulte dados de registro comercial chinês por nome da empresa ou código de crédito social unificado.
  • Rastreamento de encomendas — Acompanhe o status de entregas nas transportadoras ZTO, STO, SF Express, J&T, Best, YTO e outras.
  • Moderação de conteúdo — Verifique se há violações de política em textos, adequado para fluxos de revisão de saída de IA.

Documentação

🔥 Servidor MCP ALAPI

smithery badge License

Esta é uma implementação de servidor MCP (Model Context Protocol) baseada na ALAPI, que permite chamar diretamente as interfaces da ALAPI através do protocolo MCP, integrando facilmente os ricos recursos de API da ALAPI em diversas aplicações de IA compatíveis com MCP.

✨ Funcionalidades

  • 🔍 Ricos Recursos de API - Fornece mais de 100 serviços de API comuns, como consulta de IP, consulta de clima, listas de tendências, informações empresariais, etc.
  • 🧩 Suporte ao Protocolo MCP - Totalmente compatível com o Model Context Protocol, integrando-se facilmente a diversas aplicações de IA.
  • 🔄 Carregamento Automático - Carrega automaticamente a especificação OpenAPI da ALAPI, sem necessidade de configuração manual.
  • 🎯 Chamadas Flexíveis - Suporta carregar todas ou APIs específicas, utilizando sob demanda (análise de vídeos curtos, consulta de clima, leitura diária do mundo em 60 segundos, consulta empresarial, etc.).
  • 🛡️ Resposta Unificada - Fornece tratamento de erros e formato de resposta unificados, simplificando o fluxo de desenvolvimento.
  • ⚙️ Configurável - Suporta configuração por variáveis de ambiente, adaptando-se facilmente a diferentes cenários de uso.

📖 Guia de Uso

Primeiro, é necessário entender o protocolo MCP e, em seguida, adicionar o serviço ALAPI MCP conforme a configuração abaixo.

Uso em Clientes MCP

O Servidor MCP ALAPI foi projetado para ser usado com clientes que suportam o protocolo MCP, não suportando configuração independente por linha de comando. Siga os passos abaixo para configurar e usar em seu cliente MCP:

Método 1: MCP Remoto

Este projeto suporta implantação com um clique na plataforma de desenvolvimento em nuvem da Tencent, fornecendo acesso remoto via SSE.

☁️ Acessar plataforma de nuvem para implantar Servidor MCP

Método 2: Instalação Automática via Smithery

Instale o Servidor MCP ALAPI através do Smithery, adequado para o cliente Claude Desktop:

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

Método 3: Usar Binário Pré-compilado Diretamente (Recomendado, sem necessidade de instalar dependências)

  1. Acesse a página de Releases para baixar a versão mais recente.

    Endereço de download acelerado na China: https://cnb.cool/alapi/mcp-alapi-cn/-/releases

  2. Selecione a versão mais recente correspondente ao seu sistema operacional:

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

  3. Configure em um cliente compatível com MCP (como Claude Desktop):

    • Abra as configurações do cliente MCP.
    • Adicione um novo servidor MCP.
    • Especifique o caminho do arquivo binário baixado.
    • Configure as variáveis de ambiente necessárias (como ALAPI_TOKEN).

Configurar Variáveis de Ambiente

ALAPI_TOKEN - Token de Acesso da Plataforma ALAPI (Obrigatório)

É necessário configurar o TOKEN criado por você na plataforma ALAPI para autenticação da interface.

Exemplo de Configuração do Cliente MCP

No Claude Desktop ou outros clientes compatíveis com MCP, você pode consultar a seguinte configuração:

Configuração JSON (usando arquivo binário local)

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

Clientes MCP Suportados

De acordo com a documentação MCP, os seguintes clientes suportam integração de ferramentas MCP:

  • Claude Desktop App
  • Claude Code
  • Cursor
  • Continue
  • Cline
  • Outros clientes que suportam o protocolo MCP

Nota: Certifique-se de que seu cliente MCP suporta a funcionalidade de integração de ferramentas. Consulte a documentação específica de cada cliente para configuração.

🛠️ Funcionalidades Suportadas

A seguir estão algumas das funcionalidades suportadas. Para a lista completa, consulte as chamadas reais:

Nome da FuncionalidadeDescrição
Consulta de IPConsulta informações de localização de IP, suportando IPv4 e IPv6.
Consulta de ClimaConsulta detalhes do clima nacional, incluindo informações meteorológicas, alertas, índices, AQI, etc.
Tendências do DiaConsulta dados de tendências diárias, incluindo TikTok, manchetes, Zhihu, 36kr, Baidu, Weibo, etc.
Moderação de TextoVerifica se o texto viola regras, especialmente adequado para moderação de conteúdo de IA.
URL CurtaEncurta URLs longas para URLs curtas, facilitando envio de SMS, geração de QR code, etc.
Reconhecimento de QR CodeSuporta múltiplos códigos em uma imagem, reconhecimento de códigos bidimensionais e de barras.
Hoje na HistóriaConsulta eventos importantes ocorridos em uma data específica na história.
Consulta de CâmbioConsulta taxas de câmbio e conversão com base no código da moeda, suportando mais de 170 países e regiões.
Consulta EmpresarialConsulta informações básicas de registro empresarial por nome ou código de crédito social unificado.
Rastreamento de EncomendasRastreamento gratuito de encomendas, suportando ZTO, STO, SF, J&T, Best, YTO, etc.
HoróscopoServiço de consulta de horóscopo, suportando previsões diárias, semanais, mensais e anuais para os doze signos.
Preço do OuroConsulta o preço atual do ouro em tempo real, máxima, mínima e preços de marcas.

🔗 Links Relacionados

🙏 Agradecimentos