스마트한 사고

개요

Smart-Thinking은 Claude와 같은 AI 도우미를 위한 다차원적이고 적응적이며 자체 검증이 가능한 추론 프레임워크를 제공하는 정교한 MCP(Model Context Protocol) 서버입니다. 선형적 추론 접근 방식과 달리, Smart-Thinking은 복잡한 생각 간의 연결을 허용하는 그래프 기반 아키텍처를 사용하여 인간의 인지에 더 가까운 보다 정교한 추론 기능을 제공합니다.

Smart-Thinking은 모든 플랫폼(Windows, macOS, Linux)과 완벽하게 호환되며 Claude Desktop, Cline, Windsurf 및 기타 MCP 호환 애플리케이션을 포함한 많은 MCP 클라이언트와 원활하게 통합됩니다.

주요 특징

고급 인지 아키텍처

기존 선형 시퀀스를 대체하는 다차원 사고 그래프
필요한 생각의 수에 대한 동적이고 자체 적응적 추정
생각들 사이의 풍부하고 미묘한 연결 유형(지지, 모순, 세련 등)
맥락적 사고 측정 지표(신뢰도, 관련성, 품질)

강력한 검증 시스템

8가지 다른 상태를 통한 자동 사실 확인 및 계산
추론의 모순과 불확실성 감지
각 검증 유형에 맞춰 조정된 신뢰도 점수
상황에 맞는 확실성 요약 생성

고급 기능

이전 세션에 대한 지속적인 메모리
추론 능력을 향상시키기 위한 자기 학습 메커니즘
관련 추론을 위한 사용자 친화적 개인화
추론 과정의 대화형 시각화
팀워크를 위한 다중 에이전트 협업
MCP 도구 생태계와의 원활한 통합

크로스 플랫폼 호환성

Windows, macOS 및 Linux에서 동일하게 작동합니다.
모든 플랫폼에서 NVM(Node Version Manager)과 호환
플랫폼에 따른 파일 경로 자동 관리
각 환경에 대한 단순화된 구성
OS별 문제의 자동 해결

시설

옵션 1: 글로벌 설치(권장)

지엑스피1

옵션 2: Smithery를 통한 설치

Smithery를 통해 Smart-Thinking을 자동으로 설치하려면:

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

옵션 3: npx를 통해 사용(설치 없이)

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

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

옵션 4: 소스 코드에서 설치

# 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

Claude Desktop을 사용한 구성

macOS에서 설정

~/Library/Application Support/Claude/claude_desktop_config.json 파일에 다음 구성을 추가합니다.

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

또는 npx를 통해:

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

Windows에서의 구성

%APPDATA%\Claude\claude_desktop_config.json 파일에 다음 구성을 추가하세요.

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

또는 Node.js의 전체 경로를 사용합니다(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"]
    }
  }
}

중요한 :

VotreNom Windows 사용자 이름으로 바꾸세요.
OS가 백슬래시( \ )를 사용하더라도 Windows 경로에는 슬래시( / )를 사용합니다.

자세한 설치 지침은 설치 가이드를 참조하세요.

크로스 플랫폼 파일 시스템

Smart-Thinking은 모든 플랫폼과 호환되는 고급 파일 시스템 관리를 구현합니다.

파일 시스템 기능

자동 경로 정규화 : Windows( \ )와 Unix( / ) 경로 구분 기호 간의 원활한 변환
내장 플랫폼 감지 : OS(Windows, macOS, Linux)에 따라 자동 적응
특수 경로 처리 : Windows UNC 경로, WSL 경로 및 공백이 포함된 경로 지원
자체 구성 데이터 디렉토리 : 데이터 디렉토리의 자동 생성 및 관리
지능형 폴백 : 액세스 문제 발생 시 대체 디렉토리 자동 생성
플랫폼별 구성 경로 : OS에 따라 구성 파일의 올바른 위치

데이터 디렉토리 구성

기본적으로 Smart-Thinking은 작업 디렉토리에 data 폴더를 만들어 사용합니다. SMART_THINKING_DATA_DIR 환경 변수를 사용하여 사용자 정의 디렉토리를 지정할 수도 있습니다.

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

NVM(노드 버전 관리자) 지원

Smart-Thinking은 Node.js가 NVM을 통해 설치되었는지 자동으로 감지하고 경로를 적절히 조정하여 NVM이 설치된 Windows를 포함한 모든 플랫폼에서 완벽한 호환성을 제공합니다.

사용

주요 설정

환경	친절한	설명
`thought`	끈	분석하고자 하는 사고의 내용 (필수)
`thoughtType`	끈	사고 유형('일반', '수정', '메타', '가설', '결론')
`connections`	정렬	다른 생각과의 연결
`requestVerification`	부울	자동 검증 활성화
`containsCalculations`	부울	생각에 계산이 포함되어 있는지 표시하세요
`generateVisualization`	부울	생각 그래프 시각화 생성
`suggestTools`	부울	관련 MCP 도구 제안
`sessionId`	끈	지속성을 위한 세션 ID

사용 예

간단한 추론

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

자동 검증으로

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

시각화를 통해

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

협력 분석

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

검증 시스템

스마트씽킹은 정보와 계산의 신뢰성을 평가하는 정교한 검증 시스템을 통합합니다. 8가지의 고유한 검증 상태를 지원합니다.

상태	설명
`verified`	자신감을 가지고 검증된 정보
`partially_verified`	정보 부분적으로 확인됨
`unverified`	검증되지 않은 정보
`contradicted`	다른 출처와 모순되는 정보
`inconclusive`	검증 불확실
`absence_of_information`	해당 주제에 대한 정보 부족
`uncertain`	모순으로 인한 불확실한 정보
`contradictory`	본질적으로 모순되는 정보

이 시스템은 이러한 상태를 신뢰도, 관련성, 품질 등의 다른 측정항목과 결합해 신뢰도 점수를 계산합니다.

신뢰도 점수 계산

신뢰도 점수는 다음의 균형을 이루는 공식을 사용하여 계산됩니다.

기본 지표(신뢰성, 관련성, 품질)
검증 상태
계산 검증 결과(있는 경우)
이전 점수의 기록(시간적 평활화를 위해)

일관성을 극대화하기 위해 시뮬레이션을 통해 임계값과 점수가 최적화되었습니다.

심상

Smart-Thinking은 여러 유형의 사고 그래프 시각화를 제공합니다.

표준 그래프 : 사고 네트워크의 표준 배열
연대순 : 생각의 시간적 구성
테마 : 유사한 테마별 클러스터
계층적 : 트리 구조
힘 : 인력/반발력에 기반한 배열
방사형 : 중심 사상을 중심으로 한 동심원

시각화는 다음에 따라 필터링할 수 있습니다.

생각의 유형
연결 유형
메트릭 임계값
텍스트 검색
날짜 범위

데이터 지속성

Smart-Thinking은 다음을 저장하는 강력한 데이터 지속성 시스템을 구현합니다.

세션별 생각 그래프
향후 재사용을 위한 검증 결과
분석 및 개선을 위해 계산된 지표
개인화를 위한 사용자 기본 설정

데이터는 파일 시스템의 구조화된 JSON 파일로 플랫폼 간 호환 방식으로 저장되므로 세션 간 지속성이 보장됩니다.

MCP 클라이언트와의 호환성

Smart-Thinking은 다음을 포함한 많은 MCP 클라이언트와 호환됩니다.

Claude Desktop App : 도구, 리소스 및 프롬프트에 대한 전체 지원
클라인 : 도구 및 리소스 지원
계속 : 모든 MCP 기능에 대한 전체 지원
5번째 : 도구 지원
커서 : 도구 지원
Windsurf Editor : AI Flow 도구 지원
그리고 더 많은 것들...

순차적 사고와의 비교

기능성	순차적 사고	스마트한 사고
사고의 구조	선의	다차원(그래프)
연결 유형	경계	풍부하고 섬세한 (16가지 이상 유형)
적응	공전	역동적이고 상황에 맞는
확인	기초적인	고급(8가지 다른 상태)
심상	단순한	대화형 및 구성 가능
메모리	일시적인	벡터화에 대한 지속성
협동	아니요	예(다중 에이전트)
개인화	제한된	사용자 적응형
자기 학습	아니요	예
메트릭	기초	문맥적 및 다중적 요인
플랫폼 호환성	제한된	완료(Windows, macOS, Linux)

API 및 통합

Smart-Thinking은 다른 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);

문제 해결

빠른 작동 확인

Smart-Thinking이 올바르게 작동하는지 확인하려면:

# Sur macOS/Linux
smart-thinking-mcp

# Sur Windows
smart-thinking-mcp.cmd

서버 시작 메시지가 표시됩니다.

로그를 참조하세요

어려움이 발생하면 Claude Desktop 로그를 확인하세요.

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

일반적인 문제 및 해결책

문제	해결책
클로드에는 스마트씽킹이 등장하지 않는다	구성에서 경로를 확인하고 Claude Desktop을 다시 시작하세요.
파일 접근 오류	데이터 디렉토리의 권한을 확인하세요
Windows에서 연결 문제	슬래시를 사용하여 전체 경로와 절대 경로를 사용하세요.
Windows에서 NVM 오류	Node.js의 활성 버전에 대한 전체 경로를 사용하세요.

Windows 및 NVM 관련 문제에 대해서는 설치 가이드 의 해당 섹션을 참조하세요.

기부금

기여를 환영합니다! 자세한 내용은 기여 가이드를 확인하세요.

특허

MIT

Integrations