ALAPI

🔥 Serveur MCP ALAPI

Il s'agit d'une implémentation de serveur MCP (Model Context Protocol) basée sur ALAPI, qui permet d'appeler directement les interfaces d'ALAPI via le protocole MCP et d'intégrer facilement les riches ressources API d'ALAPI dans diverses applications d'IA compatibles MCP.

✨ Fonctionnalités

• 🔍 Richesse des ressources API - Fournit plus de 100 services API courants tels que la recherche d'IP, la météo, les classements de tendances, les informations d'entreprise, etc.
• 🧩 Prise en charge du protocole MCP - Entièrement compatible avec le Model Context Protocol, s'intègre facilement à diverses applications d'IA.
• 🔄 Chargement automatique - Charge automatiquement la spécification OpenAPI d'ALAPI, sans configuration manuelle.
• 🎯 Appel flexible - Prend en charge le chargement de toutes les API ou d'API spécifiques, à utiliser selon les besoins (analyse de courtes vidéos, météo, lecture du monde en 60 secondes par jour, recherche d'entreprise, etc.).
• 🛡️ Réponse unifiée - Fournit une gestion des erreurs et un format de réponse unifiés, simplifiant le processus de développement.
• ⚙️ Configurabilité - Prend en charge la configuration par variables d'environnement, s'adaptant facilement à différents scénarios d'utilisation.

📖 Guide d'utilisation

Vous devez d'abord comprendre le protocole MCP, puis ajouter le service MCP ALAPI selon la configuration suivante.

Utilisation dans un client MCP

Le serveur MCP ALAPI est conçu pour être utilisé avec des clients prenant en charge le protocole MCP et ne prend pas en charge la configuration autonome en ligne de commande. Veuillez suivre les étapes ci-dessous pour configurer et utiliser dans votre client MCP :

Méthode 1 : MCP distant

Ce projet prend en charge le déploiement en un clic sur la plateforme de développement cloud Tencent, offrant un accès SSE distant.

☁️ Accéder à la plateforme de développement cloud pour déployer le serveur MCP

Méthode 2 : Installation automatique avec Smithery

Installez le serveur MCP ALAPI via Smithery, adapté au client Claude Desktop :

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

Méthode 3 : Utilisation directe des binaires précompilés (recommandé, sans installation de dépendances)

1. Visitez la page Releases pour télécharger la dernière version.

   Adresse de téléchargement accéléré en Chine : https://cnb.cool/alapi/mcp-alapi-cn/-/releases

2. Sélectionnez la dernière version correspondant à votre système d'exploitation :

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

3. Configurez dans un client compatible MCP (comme Claude Desktop) :

   • Ouvrez les paramètres du client MCP.
   • Ajoutez un nouveau serveur MCP.
   • Spécifiez le chemin du fichier binaire téléchargé.
   • Configurez les variables d'environnement nécessaires (comme ALAPI_TOKEN).

Configuration des variables d'environnement

ALAPI_TOKEN - Jeton d'accès à la plateforme ALAPI (obligatoire)

Doit être configuré avec le TOKEN que vous avez créé sur la plateforme ALAPI, utilisé pour l'authentification de l'interface.

Exemple de configuration client MCP

Dans Claude Desktop ou d'autres clients compatibles MCP, vous pouvez vous référer à la configuration suivante :

Configuration JSON (utilisation du binaire local)

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

Clients MCP pris en charge

Selon la documentation MCP, les clients suivants prennent en charge l'intégration d'outils MCP :

• Application de bureau Claude
• Claude Code
• Cursor
• Continue
• Cline
• et d'autres clients prenant en charge le protocole MCP

Remarque : Assurez-vous que votre client MCP prend en charge la fonctionnalité d'intégration d'outils, veuillez consulter la documentation spécifique de chaque client pour la configuration.

🛠️ Fonctionnalités prises en charge

Voici quelques-unes des fonctionnalités prises en charge, veuillez vous référer à l'appel réel pour la liste complète :

Nom de la fonctionnalité	Description
Recherche d'IP	Recherche d'informations de localisation d'IP, prend en charge IPv4 et IPv6.
Météo	Recherche des détails météorologiques nationaux, incluant infos météo, alertes, indices, AQI, etc.
Classements du jour	Recherche des données de classements du jour, incluant les tendances Douyin, Toutiao, Zhihu, 36kr, Baidu, Weibo, etc.
Modération de texte	Vérification de conformité du texte, particulièrement adaptée à la modération de contenu IA.
URL courte	Raccourcissement d'URL longues en URL courtes, pratique pour l'envoi de SMS, la génération de QR codes, etc.
Reconnaissance de QR code	Prend en charge plusieurs codes par image, la reconnaissance de codes-barres et de dizaines de types de codes 2D.
Aujourd'hui dans l'histoire	Recherche des événements majeurs survenus à une date spécifiée dans l'histoire.
Taux de change	Recherche des taux de change et conversion selon le code devise, prend en charge plus de 170 pays et régions.
Recherche d'entreprise	Recherche d'informations commerciales de base par nom d'entreprise ou code de crédit social unifié.
Suivi de colis	Suivi gratuit des itinéraires logistiques, prend en charge ZTO, STO, SF, J&T, Best, YTO, etc.
Horoscope	Fournit un service d'horoscope, prend en charge la consultation quotidienne, hebdomadaire, mensuelle ou annuelle pour les douze signes.
Prix de l'or	Recherche du prix actuel de l'or en temps réel, prix le plus haut, le plus bas, prix des marques.

🔗 Liens connexes

• Site officiel ALAPI - Obtenez les services API et le Token.
• Documentation du protocole MCP - En savoir plus sur le protocole MCP.

🙏 Remerciements

• ALAPI - Pour le puissant support API.
• Model Context Protocol - Pour la norme du protocole.