sequential-thinking-slim 2025.12.18-slim.1.9

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 MCPSlim
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,180 @@
+# sequential-thinking-slim
+
+> **Sequential Thinking MCP server optimized for AI assistants** — Reduce context window tokens by 55.0% while keeping full functionality. Compatible with Claude, ChatGPT, Gemini, Cursor, and all MCP clients.
+
+[![npm version](https://img.shields.io/npm/v/sequential-thinking-slim.svg)](https://www.npmjs.com/package/sequential-thinking-slim)
+[![Test Status](https://img.shields.io/badge/tests-passing-brightgreen)](https://github.com/mcpslim/mcpslim)
+[![MCP Compatible](https://img.shields.io/badge/MCP-compatible-blue)](https://modelcontextprotocol.io)
+
+## What is sequential-thinking-slim?
+
+A **token-optimized** version of the Sequential Thinking [Model Context Protocol (MCP)](https://modelcontextprotocol.io) server.
+
+### The Problem
+
+MCP tool schemas consume significant **context window tokens**. When AI assistants like Claude or ChatGPT load MCP tools, each tool definition takes up valuable context space.
+
+The original `@modelcontextprotocol/server-sequential-thinking` loads **1 tools** consuming approximately **~1,529 tokens** — that's space you could use for actual conversation.
+
+### The Solution
+
+`sequential-thinking-slim` intelligently **groups 1 tools into 1 semantic operations**, reducing token usage by **55.0%** — with **zero functionality loss**.
+
+Your AI assistant sees fewer, smarter tools. Every original capability remains available.
+
+## Performance
+
+| Metric | Original | Slim | Reduction |
+|--------|----------|------|-----------|
+| Tools | 1 | 1 | **-0%** |
+| Schema Tokens | 959 | 118 | **87.7%** |
+| Claude Code (est.) | ~1,529 | ~688 | **~55.0%** |
+
+> **Benchmark Info**
+> - Original: `@modelcontextprotocol/server-sequential-thinking@2025.12.18`
+> - Schema tokens measured with [tiktoken](https://github.com/openai/tiktoken) (cl100k_base)
+> - Claude Code estimate includes ~570 tokens/tool overhead
+
+## Quick Start
+
+### One-Command Setup (Recommended)
+
+```bash
+# Claude Desktop - auto-configure
+npx sequential-thinking-slim --setup claude
+
+# Cursor - auto-configure
+npx sequential-thinking-slim --setup cursor
+
+# Interactive mode (choose your client)
+npx sequential-thinking-slim --setup
+```
+
+Done! Restart your app to use sequential-thinking.
+
+### CLI Tools (already have CLI?)
+
+```bash
+# Claude Code (creates .mcp.json in project root)
+claude mcp add sequential-thinking -s project -- npx -y sequential-thinking-slim@latest
+
+# Windows: use cmd /c wrapper
+claude mcp add sequential-thinking -s project -- cmd /c npx -y sequential-thinking-slim@latest
+
+# VS Code (Copilot, Cline, Roo Code)
+code --add-mcp '{"name":"sequential-thinking","command":"npx","args":["-y","sequential-thinking-slim@latest"]}'
+```
+
+## Manual Setup
+
+<details>
+<summary>Click to expand manual configuration options</summary>
+
+### Claude Desktop
+
+Add to your `claude_desktop_config.json`:
+
+| OS | Path |
+|----|------|
+| Windows | `%APPDATA%\Claude\claude_desktop_config.json` |
+| macOS | `~/Library/Application Support/Claude/claude_desktop_config.json` |
+
+```json
+{
+  "mcpServers": {
+    "sequential-thinking": {
+      "command": "npx",
+      "args": ["-y", "sequential-thinking-slim@latest"]
+    }
+  }
+}
+```
+
+### Cursor
+
+Add to `.cursor/mcp.json` (global) or `<project>/.cursor/mcp.json` (project):
+
+```json
+{
+  "mcpServers": {
+    "sequential-thinking": {
+      "command": "npx",
+      "args": ["-y", "sequential-thinking-slim@latest"]
+    }
+  }
+}
+```
+
+</details>
+
+## How It Works
+
+MCPSlim acts as a **transparent bridge** between AI models and the original MCP server:
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│  Without MCPSlim                                                │
+│                                                                 │
+│  [AI Model] ──── reads 1 tool schemas ────→ [Original MCP]    │
+│             (~1,529 tokens loaded into context)                 │
+├─────────────────────────────────────────────────────────────────┤
+│  With MCPSlim                                                   │
+│                                                                 │
+│  [AI Model] ───→ [MCPSlim Bridge] ───→ [Original MCP]           │
+│       │                │                      │                 │
+│   Sees 1 grouped      Translates to        Executes actual   │
+│   tools only         original call       tool & returns    │
+│   (~688 tokens)                                              │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+### How Translation Works
+
+1. **AI reads slim schema** — Only 1 grouped tools instead of 1
+2. **AI calls grouped tool** — e.g., `interaction({ action: "click", ... })`
+3. **MCPSlim translates** — Converts to original: `browser_click({ ... })`
+4. **Original MCP executes** — Real server processes the request
+5. **Response returned** — Result passes back unchanged
+
+**Zero functionality loss. 55.0% token savings.**
+
+## Available Tool Groups
+
+| Group | Actions |
+|-------|---------|
+
+
+Plus **1 passthrough tool** — tools that don't group well are kept as-is with optimized descriptions.
+
+## Compatibility
+
+- ✅ **Full functionality** — All original `@modelcontextprotocol/server-sequential-thinking` features preserved
+- ✅ **All AI assistants** — Works with Claude, ChatGPT, Gemini, Copilot, and any MCP client
+- ✅ **Drop-in replacement** — Same capabilities, just use grouped action names
+- ✅ **Tested** — Schema compatibility verified via automated tests
+
+## FAQ
+
+### Does this reduce functionality?
+
+**No.** Every original tool is accessible. Tools are grouped semantically (e.g., `click`, `hover`, `drag` → `interaction`), but all actions remain available via the `action` parameter.
+
+### Why do AI assistants need token optimization?
+
+AI models have limited context windows. MCP tool schemas consume tokens that could be used for conversation, code, or documents. Reducing tool schema size means more room for actual work.
+
+### Is this officially supported?
+
+MCPSlim is a community project. It wraps official MCP servers transparently — the original server does all the real work.
+
+## License
+
+MIT
+
+---
+
+<p align="center">
+  Powered by <a href="https://github.com/mcpslim/mcpslim"><b>MCPSlim</b></a> — MCP Token Optimizer
+  <br>
+  <sub>Reduce AI context usage. Keep full functionality.</sub>
+</p>

package/index.js

@@ -0,0 +1,271 @@
+#!/usr/bin/env node
+/**
+ * sequential-thinking-slim - Slimmed sequential-thinking MCP for Claude
+ * Reduces token usage by grouping similar tools
+ *
+ * Usage:
+ *   npx sequential-thinking-slim                    # Run MCP server
+ *   npx sequential-thinking-slim --setup            # Auto-configure (interactive)
+ *   npx sequential-thinking-slim --setup claude     # Auto-configure for Claude Desktop
+ *   npx sequential-thinking-slim --setup cursor     # Auto-configure for Cursor
+ *   npx sequential-thinking-slim --setup claude-code # Auto-configure for Claude Code CLI
+ */
+
+const { spawn, execSync } = require('child_process');
+const path = require('path');
+const os = require('os');
+const fs = require('fs');
+const readline = require('readline');
+
+const MCP_NAME = 'sequential-thinking-slim';
+const PACKAGE_NAME = 'sequential-thinking-slim';
+
+// 환경변수 요구사항 (빌드 시 주입)
+const REQUIRED_ENV_VARS = [];
+
+// ============================================
+// Setup Mode: Auto-configure MCP clients
+// ============================================
+
+const CONFIG_PATHS = {
+  'claude': getClaudeDesktopConfigPath(),
+  'claude-desktop': getClaudeDesktopConfigPath(),
+  'cursor': getCursorConfigPath(),
+};
+
+function getClaudeDesktopConfigPath() {
+  if (os.platform() === 'win32') {
+    return path.join(process.env.APPDATA || '', 'Claude', 'claude_desktop_config.json');
+  } else if (os.platform() === 'darwin') {
+    return path.join(os.homedir(), 'Library', 'Application Support', 'Claude', 'claude_desktop_config.json');
+  } else {
+    return path.join(os.homedir(), '.config', 'claude', 'claude_desktop_config.json');
+  }
+}
+
+function getCursorConfigPath() {
+  // Global config
+  if (os.platform() === 'win32') {
+    return path.join(process.env.APPDATA || '', 'Cursor', 'User', 'globalStorage', 'mcp.json');
+  } else {
+    return path.join(os.homedir(), '.cursor', 'mcp.json');
+  }
+}
+
+function addToConfig(configPath, mcpName, mcpConfig) {
+  let config = { mcpServers: {} };
+
+  // 디렉토리 생성
+  const dir = path.dirname(configPath);
+  if (!fs.existsSync(dir)) {
+    fs.mkdirSync(dir, { recursive: true });
+  }
+
+  // 기존 설정 로드
+  if (fs.existsSync(configPath)) {
+    try {
+      config = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
+      if (!config.mcpServers) config.mcpServers = {};
+    } catch (e) {
+      console.error('⚠️  Failed to parse existing config, creating new one');
+    }
+  }
+
+  // 이미 존재하는지 확인
+  if (config.mcpServers[mcpName]) {
+    console.log(`ℹ️  ${mcpName} already configured in ${configPath}`);
+    return false;
+  }
+
+  // 새 MCP 추가
+  config.mcpServers[mcpName] = mcpConfig;
+  fs.writeFileSync(configPath, JSON.stringify(config, null, 2));
+  console.log(`✅ Added ${mcpName} to ${configPath}`);
+  return true;
+}
+
+async function interactiveSetup() {
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout
+  });
+
+  const question = (q) => new Promise(resolve => rl.question(q, resolve));
+
+  console.log('\n🔧 ' + PACKAGE_NAME + ' Setup\n');
+  console.log('Select your MCP client:\n');
+  console.log('  1. Claude Desktop');
+  console.log('  2. Cursor');
+  console.log('  3. Claude Code (CLI)');
+  console.log('  4. VS Code (Copilot)');
+  console.log('  5. Cancel\n');
+
+  const choice = await question('Enter choice (1-5): ');
+  rl.close();
+
+  // 환경변수 플래그 생성
+  const envFlags = REQUIRED_ENV_VARS.map(v => `--env ${v}=<YOUR_${v.split('_').pop()}>`).join(' ');
+  const envJson = REQUIRED_ENV_VARS.length > 0
+    ? `,"env":{${REQUIRED_ENV_VARS.map(v => `"${v}":"<YOUR_${v.split('_').pop()}>"`).join(',')}}`
+    : '';
+
+  switch (choice.trim()) {
+    case '1':
+      return setupClient('claude');
+    case '2':
+      return setupClient('cursor');
+    case '3':
+      console.log('\nRun this command:\n');
+      if (REQUIRED_ENV_VARS.length > 0) {
+        console.log(`  claude mcp add ${MCP_NAME} -s project ${envFlags} -- npx -y ${PACKAGE_NAME}@latest\n`);
+      } else {
+        console.log(`  claude mcp add ${MCP_NAME} -s project -- npx -y ${PACKAGE_NAME}@latest\n`);
+      }
+      console.log('  (Windows: use "cmd /c npx" instead of "npx")\n');
+      return true;
+    case '4':
+      console.log('\nRun this command:\n');
+      console.log(`  code --add-mcp '{"name":"${MCP_NAME}","command":"npx","args":["-y","${PACKAGE_NAME}@latest"]${envJson}}'\n`);
+      return true;
+    case '5':
+    default:
+      console.log('Cancelled.');
+      return false;
+  }
+}
+
+function setupClaudeCode() {
+  // 환경변수 플래그 생성
+  const envFlags = REQUIRED_ENV_VARS.map(v => `--env ${v}=<YOUR_${v.split('_').pop()}>`).join(' ');
+
+  // Windows에서는 cmd /c wrapper 필요
+  const npxCmd = os.platform() === 'win32' ? 'cmd /c npx' : 'npx';
+
+  let cmd = `claude mcp add ${MCP_NAME} -s project`;
+  if (REQUIRED_ENV_VARS.length > 0) {
+    cmd += ` ${envFlags}`;
+  }
+  cmd += ` -- ${npxCmd} -y ${PACKAGE_NAME}@latest`;
+
+  console.log(`\n🔧 Adding ${MCP_NAME} to Claude Code...\n`);
+  console.log(`Running: ${cmd}\n`);
+
+  try {
+    execSync(cmd, { stdio: 'inherit', shell: true });
+    console.log(`\n🎉 Setup complete! ${MCP_NAME} is now available in Claude Code.\n`);
+    if (REQUIRED_ENV_VARS.length > 0) {
+      console.log(`⚠️  Don't forget to set environment variables:`);
+      for (const envVar of REQUIRED_ENV_VARS) {
+        console.log(`   - ${envVar}`);
+      }
+      console.log('');
+    }
+    return true;
+  } catch (err) {
+    console.error(`\n❌ Failed to add MCP. Is Claude Code CLI installed?\n`);
+    console.log(`Try running manually:\n  ${cmd}\n`);
+    return false;
+  }
+}
+
+function setupClient(client) {
+  // Claude Code CLI는 별도 처리
+  if (client === 'claude-code') {
+    return setupClaudeCode();
+  }
+
+  const configPath = CONFIG_PATHS[client];
+  if (!configPath) {
+    console.error(`❌ Unknown client: ${client}`);
+    console.log('Supported: claude, claude-desktop, cursor, claude-code');
+    return false;
+  }
+
+  const mcpConfig = {
+    command: 'npx',
+    args: ['-y', PACKAGE_NAME + '@latest']
+  };
+
+  // 환경변수가 필요한 경우 env 블록 추가 (플레이스홀더)
+  if (REQUIRED_ENV_VARS.length > 0) {
+    mcpConfig.env = {};
+    for (const envVar of REQUIRED_ENV_VARS) {
+      mcpConfig.env[envVar] = `<YOUR_${envVar.split('_').pop()}>`;
+    }
+  }
+
+  const success = addToConfig(configPath, MCP_NAME, mcpConfig);
+
+  if (success) {
+    if (REQUIRED_ENV_VARS.length > 0) {
+      console.log(`\n⚠️  This MCP requires environment variables!`);
+      console.log(`   Edit ${configPath} and update:`);
+      for (const envVar of REQUIRED_ENV_VARS) {
+        console.log(`     - ${envVar}`);
+      }
+      console.log(`\n🎉 Setup complete! Update env vars, then restart ${client}.\n`);
+    } else {
+      console.log(`\n🎉 Setup complete! Restart ${client} to use ${MCP_NAME}.\n`);
+    }
+  }
+
+  return success;
+}
+
+// ============================================
+// Main: Check for --setup flag
+// ============================================
+
+const args = process.argv.slice(2);
+const setupIndex = args.indexOf('--setup');
+
+if (setupIndex !== -1) {
+  const client = args[setupIndex + 1];
+
+  if (client && !client.startsWith('-')) {
+    // Specific client: npx xxx-slim --setup claude
+    setupClient(client);
+  } else {
+    // Interactive: npx xxx-slim --setup
+    interactiveSetup().then(() => process.exit(0));
+  }
+} else {
+  // ============================================
+  // Normal Mode: Run MCP server
+  // ============================================
+
+  // 플랫폼별 바이너리 이름 결정
+  function getBinaryName() {
+    const platform = os.platform();
+    const arch = os.arch();
+    if (platform === 'win32') {
+      return 'mcpslim-windows-x64.exe';
+    } else if (platform === 'darwin') {
+      return arch === 'arm64' ? 'mcpslim-darwin-arm64' : 'mcpslim-darwin-x64';
+    } else {
+      return 'mcpslim-linux-x64';
+    }
+  }
+
+  const binName = getBinaryName();
+  const mcpslimBin = path.join(__dirname, 'bin', binName);
+  const recipePath = path.join(__dirname, 'recipes', 'sequential-thinking.json');
+
+  // 원본 MCP 명령어
+  const originalMcp = process.env.MCPSLIM_ORIGINAL_MCP?.split(' ')
+    || ["npx","-y","@modelcontextprotocol/server-sequential-thinking"];
+
+  const bridgeArgs = ['bridge', '--recipe', recipePath, '--', ...originalMcp];
+
+  const child = spawn(mcpslimBin, bridgeArgs, {
+    stdio: 'inherit',
+    windowsHide: true
+  });
+
+  child.on('error', (err) => {
+    console.error('Failed to start MCPSlim:', err.message);
+    process.exit(1);
+  });
+
+  child.on('exit', (code) => process.exit(code || 0));
+}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "sequential-thinking-slim",
+  "version": "2025.12.18-slim.1.9",
+  "description": "sequential-thinking MCP (0% less tokens). Quick setup: npx sequential-thinking-slim --setup",
+  "bin": {
+    "sequential-thinking-slim": "./index.js"
+  },
+  "keywords": [
+    "mcp",
+    "claude",
+    "gemini",
+    "chatgpt",
+    "sequential-thinking",
+    "slim",
+    "token-reduction"
+  ],
+  "author": "",
+  "license": "MIT",
+  "files": [
+    "bin/",
+    "recipes/",
+    "index.js",
+    "README.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/mcpslim/sequential-thinking-slim.git"
+  },
+  "mcpslim": {
+    "originalPackage": "@modelcontextprotocol/server-sequential-thinking",
+    "originalVersion": "2025.12.18",
+    "originalTools": 1,
+    "slimTools": 1,
+    "tokenReduction": "0%"
+  },
+  "homepage": "https://mcpslim.github.io/sequential-thinking-slim",
+  "bugs": {
+    "url": "https://github.com/mcpslim/sequential-thinking-slim/issues"
+  }
+}

package/recipes/sequential-thinking.json

@@ -0,0 +1,13 @@
+{
+  "mcp_name": "sequential-thinking",
+  "auto_generated": true,
+  "algorithm_version": "v2.1",
+  "rules": {
+    "default_minifier": "first_sentence",
+    "remove_params_description": false
+  },
+  "groups": [],
+  "passthrough": [
+    "sequentialthinking"
+  ]
+}