Smart-Thinking

Vue d'ensemble

Smart-Thinking est un serveur MCP (Model Context Protocol) sophistiqué qui fournit un cadre de raisonnement multi-dimensionnel, adaptatif et auto-vérifiable pour les assistants IA comme Claude. Contrairement aux approches de raisonnement linéaire, Smart-Thinking utilise une architecture basée sur des graphes qui permet des connexions complexes entre les pensées, offrant ainsi une capacité de raisonnement plus nuancée et plus proche de la cognition humaine.

Smart-Thinking est entièrement compatible avec toutes les plateformes (Windows, macOS, Linux) et s'intègre parfaitement avec de nombreux clients MCP, notamment Claude Desktop, Cline, Windsurf et d'autres applications compatibles MCP.

Caractéristiques clés

Architecture cognitive avancée

Graphe de pensée multi-dimensionnel remplaçant les séquences linéaires traditionnelles
Estimation dynamique et auto-adaptative du nombre de pensées nécessaires
Types de connexions riches et nuancés entre les pensées (supports, contradicts, refines, etc.)
Métriques de pensée contextuelles (confidence, relevance, quality)

Système de vérification robuste

Vérification automatique des faits et calculs avec 8 statuts différents
Détection des contradictions et incertitudes dans le raisonnement
Scores de fiabilité adaptés à chaque type de vérification
Génération de résumés de certitude adaptés au contexte

Fonctionnalités avancées

Mémoire persistante pour les sessions précédentes
Mécanismes d'auto-apprentissage pour améliorer le raisonnement
Personnalisation adaptée à l'utilisateur pour un raisonnement pertinent
Visualisations interactives du processus de raisonnement
Collaboration multi-agents pour le travail d'équipe
Intégration transparente avec l'écosystème d'outils MCP

Compatibilité cross-plateforme

Fonctionne de manière identique sur Windows, macOS et Linux
Compatible avec NVM (Node Version Manager) sur toutes les plateformes
Gestion automatique des chemins de fichiers selon la plateforme
Configuration simplifiée pour chaque environnement
Résolution automatique des problèmes spécifiques à chaque OS

Installation

Option 1: Installation globale (recommandée)

# Sur macOS/Linux
npm install -g smart-thinking-mcp

# Sur Windows (depuis PowerShell ou CMD)
npm install -g smart-thinking-mcp

Option 2: Installation via Smithery

Pour installer Smart-Thinking automatiquement via Smithery:

npx -y @smithery/cli install @Leghis/smart-thinking --client claude

Option 3: Utilisation via npx (sans installation)

# Sur macOS/Linux
npx -y smart-thinking-mcp

# Sur Windows (moins recommandé, préférez l'installation globale)
npx -y smart-thinking-mcp

Option 4: Installation depuis le code source

# Cloner le dépôt
git clone https://github.com/Leghis/Smart-Thinking.git
cd Smart-Thinking

# Installer les dépendances
npm install

# Compiler le projet
npm run build

# Créer un lien npm global
npm link

Configuration avec Claude Desktop

Configuration sur macOS

Ajoutez cette configuration à votre fichier ~/Library/Application Support/Claude/claude_desktop_config.json :

{
  "mcpServers": {
    "smart-thinking": {
      "command": "smart-thinking-mcp"
    }
  }
}

OU via npx:

{
  "mcpServers": {
    "smart-thinking": {
      "command": "npx",
      "args": ["-y", "smart-thinking-mcp"]
    }
  }
}

Configuration sur Windows

Ajoutez cette configuration à votre fichier %APPDATA%\Claude\claude_desktop_config.json :

{
  "mcpServers": {
    "smart-thinking": {
      "command": "C:/Users/VotreNom/AppData/Roaming/npm/smart-thinking-mcp.cmd"
    }
  }
}

OU avec le chemin complet vers Node.js (recommandé pour Windows):

{
  "mcpServers": {
    "smart-thinking": {
      "command": "C:/Program Files/nodejs/node.exe",
      "args": ["C:/Users/VotreNom/AppData/Roaming/npm/node_modules/smart-thinking-mcp/build/index.js"]
    }
  }
}

Important:

Remplacez VotreNom par votre nom d'utilisateur Windows.
Utilisez des forward slashes (/) dans les chemins Windows, même si l'OS utilise des backslashes (\).

Pour des instructions d'installation détaillées, consultez le Guide d'installation.

Système de fichiers cross-plateforme

Smart-Thinking implémente une gestion avancée du système de fichiers compatible avec toutes les plateformes:

Fonctionnalités du système de fichiers

Normalisation automatique des chemins: Conversion transparente entre les séparateurs de chemin Windows (\) et Unix (/)
Détection de plateforme intégrée: Adaptation automatique selon l'OS (Windows, macOS, Linux)
Gestion des chemins spéciaux: Support pour les chemins UNC Windows, WSL et les chemins avec espaces
Répertoire de données auto-configuré: Création et gestion automatique du répertoire de données
Fallback intelligent: Création automatique d'un répertoire alternatif en cas de problème d'accès
Chemins de configuration spécifiques à la plateforme: Localisation correcte des fichiers de configuration selon l'OS

Configuration du répertoire de données

Par défaut, Smart-Thinking crée et utilise un dossier data dans son répertoire de travail. Vous pouvez également spécifier un répertoire personnalisé avec la variable d'environnement SMART_THINKING_DATA_DIR:

{
  "mcpServers": {
    "smart-thinking": {
      "command": "smart-thinking-mcp",
      "env": {
        "SMART_THINKING_DATA_DIR": "/chemin/absolu/vers/data"
      }
    }
  }
}

Support pour NVM (Node Version Manager)

Smart-Thinking détecte automatiquement si Node.js est installé via NVM et adapte les chemins en conséquence, offrant une compatibilité parfaite sur toutes les plateformes, y compris Windows avec NVM.

Utilisation

Paramètres principaux

Paramètre	Type	Description
`thought`	string	Contenu de la pensée à analyser (obligatoire)
`thoughtType`	string	Type de pensée ('regular', 'revision', 'meta', 'hypothesis', 'conclusion')
`connections`	array	Connexions à d'autres pensées
`requestVerification`	boolean	Activer la vérification automatique
`containsCalculations`	boolean	Indiquer si la pensée contient des calculs
`generateVisualization`	boolean	Générer une visualisation du graphe de pensée
`suggestTools`	boolean	Suggérer des outils MCP pertinents
`sessionId`	string	Identifiant de session pour la persistance

Exemples d'utilisation

Raisonnement simple

Utilise l'outil Smart-Thinking pour analyser les avantages et inconvénients des énergies renouvelables.

Avec vérification automatique

Utilise Smart-Thinking avec vérification (requestVerification=true) pour évaluer les affirmations suivantes sur le changement climatique.

Avec visualisation

Utilise Smart-Thinking avec visualisation (generateVisualization=true) pour développer une stratégie marketing multicouche.

Analyse collaborative

Utilise Smart-Thinking avec un identifiant de session (sessionId="projet-innovation") pour analyser ce problème complexe d'optimisation.

Système de vérification

Smart-Thinking intègre un système sophistiqué de vérification qui évalue la fiabilité des informations et des calculs. Il prend en charge 8 statuts de vérification distincts :

Statut	Description
`verified`	Information vérifiée avec confiance
`partially_verified`	Information partiellement vérifiée
`unverified`	Information non vérifiée
`contradicted`	Information contredite par d'autres sources
`inconclusive`	Vérification non concluante
`absence_of_information`	Absence d'information sur le sujet
`uncertain`	Information incertaine à cause de contradictions
`contradictory`	Information intrinsèquement contradictoire

Le système calcule un score de fiabilité qui combine ces statuts avec d'autres métriques comme la confiance, la pertinence et la qualité.

Calcul du score de fiabilité

Le score de fiabilité est calculé selon une formule qui équilibre :

Les métriques de base (confiance, pertinence, qualité)
Le statut de vérification
Les résultats de vérification des calculs (si présents)
L'historique des scores précédents (pour un lissage temporel)

Les seuils et les scores ont été optimisés par simulation pour garantir une cohérence maximale.

Visualisation

Smart-Thinking propose plusieurs types de visualisations du graphe de pensée :

Graphe standard: Disposition standard du réseau de pensées
Chronologique: Organisation temporelle des pensées
Thématique: Clusters par thèmes similaires
Hiérarchique: Structure arborescente
Force: Disposition basée sur les forces d'attraction/répulsion
Radiale: Cercles concentriques autour d'une pensée centrale

Les visualisations peuvent être filtrées selon :

Types de pensées
Types de connexions
Seuils de métriques
Recherche textuelle
Plages de dates

Persistance des données

Smart-Thinking implémente un système robuste de persistance des données qui stocke :

Les graphes de pensée par session
Les résultats de vérification pour une réutilisation future
Les métriques calculées pour analyse et amélioration
Les préférences utilisateur pour personnalisation

Les données sont stockées de manière compatible cross-plateforme dans des fichiers JSON structurés sur le système de fichiers, garantissant la persistance entre les sessions.

Compatibilité avec les clients MCP

Smart-Thinking est compatible avec de nombreux clients MCP, dont :

Claude Desktop App: Support complet des outils, ressources et prompts
Cline: Support pour les outils et ressources
Continue: Support complet pour toutes les fonctionnalités MCP
5ire: Support pour les outils
Cursor: Support pour les outils
Windsurf Editor: Support pour les outils AI Flow
Et plus encore...

Comparaison avec Sequential-Thinking

Fonctionnalité	Sequential-Thinking	Smart-Thinking
Structure de pensée	Linéaire	Multi-dimensionnelle (graphe)
Types de connexions	Limités	Riches et nuancés (16+ types)
Adaptation	Statique	Dynamique et contextuelle
Vérification	Basique	Avancée (8 statuts différents)
Visualisation	Simple	Interactive et paramétrable
Mémoire	Temporaire	Persistante avec vectorisation
Collaboration	Non	Oui (multi-agents)
Personnalisation	Limitée	Adaptative à l'utilisateur
Auto-apprentissage	Non	Oui
Métriques	Basiques	Contextuelle et multi-facteurs
Compatibilité plateforme	Limitée	Complète (Windows, macOS, Linux)

API et intégration

Smart-Thinking peut être intégré dans d'autres applications Node.js :

import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
import { SmartThinking } from 'smart-thinking-mcp';

// Initialiser Smart-Thinking
const smartThinking = new SmartThinking({
  persistenceEnabled: true,
  verificationEnabled: true
});

// Utiliser les fonctionnalités
const result = await smartThinking.processThought({
  thought: "Cette pensée sera analysée et vérifiée",
  requestVerification: true
});

console.log(result.qualityMetrics);
console.log(result.verificationStatus);

Résolution des problèmes

Vérification rapide du fonctionnement

Pour vérifier que Smart-Thinking fonctionne correctement:

# Sur macOS/Linux
smart-thinking-mcp

# Sur Windows
smart-thinking-mcp.cmd

Vous devriez voir le message de démarrage du serveur.

Consulter les logs

Si vous rencontrez des difficultés, consultez les logs de Claude Desktop :

Sur macOS : ~/Library/Logs/Claude/mcp*.log
Sur Windows : %USERPROFILE%\AppData\Local\Claude\logs\mcp*.log
Sur Linux : ~/.local/share/Claude/logs/mcp*.log

Problèmes courants et solutions

Problème	Solution
Smart-Thinking n'apparaît pas dans Claude	Vérifiez les chemins dans la configuration, redémarrez Claude Desktop
Erreurs d'accès aux fichiers	Vérifiez les permissions du répertoire de données
Problèmes de connexion sur Windows	Utilisez des chemins complets et absolus avec forward slashes
Erreurs avec NVM sur Windows	Utilisez le chemin complet vers la version active de Node.js

Pour les problèmes spécifiques à Windows et NVM, consultez la section dédiée dans le Guide d'installation.

Contribution

Les contributions sont les bienvenues ! Consultez notre Guide de contribution pour plus d'informations.

Licence

MIT

Integrations