AgenticForge

Pourquoi AgentMCP ?

🔒 Entièrement Local et Privé - Tout fonctionne sur votre machine — pas de cloud, pas de partage de données. Vos fichiers, conversations et outils restent privés.

🛠️ Auto-Forge d'Outils MCP - AgentMCP code directement des outils MCP personnalisés en TypeScript avec schémas Zod, les intègre au worker en temps réel et les affiche dans l'interface graphique avec transparence totale.

💰 Fonctionnement Gratuit Prolongé - Grâce à une astuce de gestion de clés, notamment avec Qwen, AgentMCP peut fonctionner en continu pendant plusieurs jours sans frais.

🤖 Contrôle de Sous-Agents - Capable d'orchestrer et de contrôler d'autres agents en ligne de commande (CLI) pour déléguer et paralléliser des tâches complexes.

💻 Assistant de Codage Autonome - Besoin de code ? Il peut écrire, déboguer et exécuter des programmes en Python, TypeScript, Bash et plus — sans supervision.

🧠 Sélection Intelligente d'Outils - Vous demandez, il trouve automatiquement le meilleur outil pour le travail. Comme avoir une forge d'experts prêts à aider.

📋 Planifie et Exécute des Tâches Complexes - De la gestion de fichiers au scraping web — il peut diviser les grandes tâches en étapes et forger les outils pour accomplir le travail.

🌐 Navigation Web Intelligente - AgentMCP peut naviguer sur internet de manière autonome — rechercher, lire, extraire des infos, automatiser des tâches — le tout sans intervention.

🔄 LlmKeyManager Intelligent - Système de gestion avancé des clés API avec basculement automatique, monitoring de performance et désactivation temporaire des clés défaillantes.

🚀 Forge MCP Native - Utilise le protocole MCP avec FastMCP pour créer, modifier et déployer des outils personnalisés en temps réel. Chaque outil est codé, testé et intégré automatiquement au worker. Les outils créés avec MCP sont directement accessibles pour un agent n8n.

🛠️ ⚠️ Travail Actif en Cours

🙏 Ce projet a commencé pour prouver que MCP était mieux que API et a grandi au-delà des attentes. Les contributions, commentaires et patience sont profondément appréciés alors que nous forgeons de l'avant.

📋 Prérequis

Requis pour l'installation :

• Docker Engine & Docker Compose : Pour les services principaux
  • Docker Desktop (recommandé) : Windows | Mac | Linux
  • Ou Docker Engine + Docker Compose
• Node.js 20+ : Pour le build et le worker local
  • Télécharger Node.js
• pnpm : Gestionnaire de paquets

  npm install -g pnpm
  

• Git : Pour cloner le projet

🖥️ Compatibilité Système

AgentMCP est conçu pour être déployé sur Linux ou macOS.
Windows n'est pas officiellement supporté.

🚀 Installation Production

🤖 Installation Ultra-Simple (100% Automatique)

Option 1: Installation en une ligne

curl -fsSL https://raw.githubusercontent.com/Jboner-Corvus/AgenticForge/main/install.sh | bash

Option 2: Installation classique

# 1. Cloner le projet
git clone https://github.com/Jboner-Corvus/AgenticForge.git
cd AgenticForge

# 2. Installation complètement automatisée
chmod +x run.sh
./run.sh install

Option 3: Installation interactive

# 1. Cloner le projet
git clone https://github.com/Jboner-Corvus/AgenticForge.git
cd AgenticForge

# 2. Lancer la console de gestion AgentMCP
chmod +x run.sh
./run.sh

Console de Gestion Production :

    ╔══════════════════════════════════╗
    ║           A G E N T M C P        ║
    ╚══════════════════════════════════╝
──────────────────────────────────────────
    Docker & Services
    1) 🟢 Start Services            5) 📊 Worker Logs
    2) 🔄 Restart All               6) 🐚 Container Shell
    3) 🔴 Stop Services              7) 🔨 Rebuild All
    4) ⚡ Status                    8) 🐳 Docker Logs

    Testing & Quality
    9) 🔬 Unit Tests Only           12) 🔍 Lint Code
   10) 🔗 Integration Tests         13) ✨ Format Code
   11) 🧪 All Tests                14) 📘 Type Check

   15) 🚪 Exit

Choisissez "1) 🟢 Start Services" pour l'installation automatique

🔧 Au premier démarrage, le système :

• Crée automatiquement le fichier .env avec des valeurs par défaut
• Installe les dépendances pnpm nécessaires
• Build les packages core et UI
• Lance tous les services Docker
• Configure l'environnement de production

⚙️ Configuration Rapide

Configuration Initiale

Au premier démarrage, le fichier .env est créé avec des valeurs par défaut. Vous pouvez y définir votre première clé API pour un démarrage rapide.

# === CONFIGURATION AgentMCP ===

# Ports d'accès
PUBLIC_PORT=8080          # API et serveur principal
WEB_PORT=3002            # Interface utilisateur

# Base de données et cache
REDIS_HOST=localhost
REDIS_PORT=6379
REDIS_PASSWORD=""        # Laissez vide pour un usage local

# Intelligence Artificielle - Clé de démarrage
LLM_API_KEY="votre_cle_api_preferee"
LLM_PROVIDER="gemini"          # ou "openai", "anthropic", "grok", "qwen", etc.
LLM_MODEL_NAME="gemini-2.5-pro"   # Modèle correspondant au provider
LLM_API_BASE_URL=""            # Optionnel, auto-détecté si non fourni
QWEN_API_BASE_URL="https://dashscope.aliyuncs.com/api/v1/services/aigc/text-generation/generation"  # Pour le fournisseur Qwen

# Sécurité
AUTH_TOKEN="$(openssl rand -hex 32)"     # Généré automatiquement

# Environnement
NODE_ENV=production
LOG_LEVEL=info

🔑 Gestion Multi-Clés API via l'Interface Web

AgentMCP intègre un LlmKeyManager puissant pour une gestion centralisée et dynamique de vos clés API, accessible directement depuis l'interface web.

1. Accédez à l'interface : Ouvrez votre navigateur sur http://localhost:3002.
2. Allez dans le "LLM Key Manager" : Utilisez le menu pour naviguer vers la page de gestion des clés.

Fonctionnalités du LlmKeyManager :

• Ajout/Suppression de Clés en Temps Réel : Ajoutez ou supprimez des clés API pour différents fournisseurs (OpenAI, Gemini, Anthropic, etc.) sans redémarrer le système.
• Activation/Désactivation : Activez ou désactivez des clés à la volée.
• Basculement Automatique (Failover) : Si une clé API échoue (limite de requêtes atteinte, erreur), le système bascule automatiquement sur la prochaine clé valide pour garantir une continuité de service.
• Monitoring et Statistiques : Suivez l'utilisation de vos clés, le nombre de clés actives, et le nombre de fournisseurs configurés.
• Tests de Validité : Testez la validité de chaque clé directement depuis l'interface.

Ajout de Clés Supplémentaires

1. Via l'Interface Web : localhost:3002 → Onglet "Clés API"
2. Fonctionnalités :
   • ✅ Ajout/suppression de clés en temps réel
   • ✅ Basculement automatique en cas d'erreur

Configuration du Fournisseur Qwen

Pour utiliser le fournisseur Qwen, vous devez :

1. Obtenir une clé API depuis Qwen Portal
2. Configurer les variables d'environnement suivantes :

LLM_PROVIDER=qwen
LLM_MODEL_NAME=qwen3-coder-plus
LLM_API_KEY=votre_cle_api_qwen
QWEN_API_BASE_URL=https://portal.qwen.ai/v1/chat/completions

Consultez le fichier docs/QWEN_PROVIDER.md pour plus de détails sur la configuration et le dépannage du fournisseur Qwen.

🔧 Outils de Dépannage Qwen

Des scripts utilitaires sont disponibles pour diagnostiquer et résoudre les problèmes de connexion Qwen :

• scripts/diagnose-qwen-connection.ts - Diagnostic complet des connexions
• scripts/validate-qwen-key.ts - Validation des clés API
• scripts/test-qwen-provider.ts - Test de base du fournisseur

Pour exécuter ces scripts :

cd /chemin/vers/AgentMCP
ts-node scripts/diagnose-qwen-connection.ts

Consultez QWEN_OPTIMIZATION_SUMMARY.md pour un résumé complet des améliorations apportées au fournisseur Qwen.

🤖 Configuration IA

Option 1 : API Cloud (Recommandée pour débuter)

Option 2 : IA Locale (Pour la confidentialité)

Ollama

1. Installer Ollama : ollama.ai
2. Télécharger un modèle :

   ollama pull deepseek-r1:14b  # Recommandé pour la plupart des tâches
   ollama serve
   

LM Studio

1. Installer LM Studio : lmstudio.ai
2. Télécharger un modèle et démarrer le serveur local
3. Configuration :

   LLM_PROVIDER="openai"
   LLM_API_BASE_URL="http://localhost:1234/v1"
   LLM_API_KEY="lm-studio"  # Valeur quelconque
   LLM_MODEL_NAME="votre-modele-local"
   

Note : Le système détecte automatiquement les serveurs locaux

🚀 Gestion du Système

Console de Gestion Interactive

# Accéder à toutes les fonctionnalités via la console
./run.sh

Gestion Système Avancée

⚙️ Architecture Production

Stack Technique

• 🧠 Serveur Principal : API REST, orchestration IA, gestion des sessions
• 🌐 Interface Web : Application React avec streaming temps réel
• 💾 Redis : Cache haute performance et message broker
• 🗄️ PostgreSQL : Stockage persistant des sessions et outils
• 🐳 Docker Compose : Orchestration complète des services
• 📊 OpenTelemetry : Observabilité et monitoring

Processus de Forge d'Outils

1. Analyse → L'IA comprend le besoin utilisateur
2. Conception → Génération du code TypeScript/Python
3. Validation → Tests automatiques et vérification
4. Intégration → Ajout au catalogue d'outils
5. Exécution → Disponible instantanément dans l'interface

Licence

Ce projet est sous licence MIT. Voir le fichier LICENSE pour les détails.

Remerciements

• FastMCP : Framework MCP ultra-performant - la fusée qui propulse AgentMCP 🚀
• Model Context Protocol (MCP) : Protocole révolutionnaire pour l'interaction avec les LLMs
• Docker : Conteneurisation et isolation
• Redis : Structures de données haute performance
• Playwright : Automatisation web moderne
• Communauté Open Source : Pour l'inspiration et la collaboration

Support

• 🚨 Issues : GitHub Issues
• 💬 Discussions : GitHub Discussions
• 📚 Documentation : Wiki du Projet
• 🎮 Discord : Rejoignez la communauté - Partagez vos créations, obtenez de l'aide en temps réel et découvrez les dernières nouveautés en avant-première

🔨 Un forgeron forge ses marteaux. 🤖 AgentMCP forge ses propres capacités.

Forgez votre avenir technologique.