seqThinkMCP by r2cuerdame - MCP Server

Sequential Thinking MCP Server

SSE(Server-Sent Events)를 지원하는 Sequential Thinking MCP 서버입니다.

🌟 주요 기능

Sequential Thinking: 체계적인 사고 과정 추적
Thought Branching: 사고의 분기 및 발전
Session Management: 다중 세션 지원
SSE Streaming: 실시간 사고 과정 스트리밍
MCP Protocol: Claude Code와 완전 호환

🚀 빠른 시작

1. 개발 모드 실행

cd seqThinkMCP
npm install
npm run dev

2. 프로덕션 빌드

npm run build
npm start

3. Docker 실행

# Docker Compose 사용
docker-compose up -d

# 또는 직접 Docker 빌드
docker build -t seq-think-mcp .
docker run -p 3001:3001 seq-think-mcp

🔧 MCP 도구

`think`

새로운 사고를 추가하거나 기존 사고를 수정합니다.

{
  "content": "사고 내용",
  "revise": 3,  // 선택적: 수정할 사고 ID
  "sessionId": "session-1"  // 선택적: 세션 ID
}

`get_thoughts`

사고 목록을 조회합니다.

{
  "sessionId": "session-1",  // 선택적
  "limit": 10  // 선택적: 최근 N개만
}

`branch_thought`

기존 사고에서 새로운 분기를 생성합니다.

{
  "thoughtId": 5,
  "content": "분기된 새로운 사고",
  "sessionId": "session-1"
}

`get_thought_tree`

사고의 트리 구조를 조회합니다.

`clear_thoughts`

세션의 모든 사고를 지웁니다.

`create_session`

새로운 사고 세션을 생성합니다.

🌐 API 엔드포인트

GET /: 서버 정보
GET /health: 헬스체크
POST /mcp/messages/: MCP 메시지 처리 (SSE 지원)
GET /sessions: 세션 관리

📊 SSE 스트리밍

think 도구 호출 시 실시간 사고 과정을 SSE로 스트리밍:

// SSE 이벤트 예시
data: {"type": "connected"}
data: {"type": "progress", "step": 1, "message": "Processing your thought..."}
data: {"type": "progress", "step": 2, "message": "Analyzing content..."}
data: {"jsonrpc": "2.0", "id": 1, "result": {...}}
data: {"type": "complete"}

🔗 Claude Code 연동

Claude Code의 claude_desktop_config.json에 추가:

{
  "mcpServers": {
    "sequential-thinking": {
      "command": "node",
      "args": ["/path/to/seqThinkMCP/dist/index.js"]
    }
  }
}

또는 HTTP 방식으로:

{
  "mcpServers": {
    "sequential-thinking": {
      "command": "curl",
      "args": ["-X", "POST", "http://localhost:3001/mcp/messages/", "-H", "Content-Type: application/json", "-d", "@-"]
    }
  }
}

🧪 테스트

# 서버 시작 후 테스트
curl http://localhost:3001/health

# MCP 도구 테스트
curl -X POST http://localhost:3001/mcp/messages/ \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list"
  }'

📝 라이센스

MIT License