serena-slim 0.0.1-slim.1 → 0.0.1-slim.1.10

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

@@ -1,6 +1,6 @@
 # serena-slim
 
-> **Serena MCP server optimized for AI assistants** — Reduce context window tokens by 51.2% while keeping full functionality. Compatible with Claude, ChatGPT, Gemini, Cursor, and all MCP clients.
+> **Serena MCP server optimized for AI assistants** — Reduce context window tokens by 50.3% while keeping full functionality. Compatible with Claude, ChatGPT, Gemini, Cursor, and all MCP clients.
 
 [![npm version](https://img.shields.io/npm/v/serena-slim.svg)](https://www.npmjs.com/package/serena-slim)
 [![Test Status](https://img.shields.io/badge/tests-passing-brightgreen)](https://github.com/mcpslim/mcpslim)
@@ -18,7 +18,7 @@ The original `serena` loads **29 tools** consuming approximately **~23,878 token
 
 ### The Solution
 
-`serena-slim` intelligently **groups 29 tools into 18 semantic operations**, reducing token usage by **51.2%** — with **zero functionality loss**.
+`serena-slim` intelligently **groups 29 tools into 18 semantic operations**, reducing token usage by **50.3%** — with **zero functionality loss**.
 
 Your AI assistant sees fewer, smarter tools. Every original capability remains available.
 
@@ -27,8 +27,8 @@ Your AI assistant sees fewer, smarter tools. Every original capability remains a
 | Metric | Original | Slim | Reduction |
 |--------|----------|------|-----------|
 | Tools | 29 | 18 | **-38%** |
-| Schema Tokens | 7,348 | 1,395 | **81.0%** |
-| Claude Code (est.) | ~23,878 | ~11,655 | **~51.2%** |
+| Schema Tokens | 7,348 | 1,614 | **78.0%** |
+| Claude Code (est.) | ~23,878 | ~11,874 | **~50.3%** |
 
 > **Benchmark Info**
 > - Original: `serena@0.0.1`
@@ -55,11 +55,14 @@ Done! Restart your app to use serena.
 ### CLI Tools (already have CLI?)
 
 ```bash
-# Claude Code
-claude mcp add serena -- npx -y serena-slim
+# Claude Code (creates .mcp.json in project root)
+claude mcp add serena -s project -- npx -y serena-slim@latest
+
+# Windows: use cmd /c wrapper
+claude mcp add serena -s project -- cmd /c npx -y serena-slim@latest
 
 # VS Code (Copilot, Cline, Roo Code)
-code --add-mcp '{"name":"serena","command":"npx","args":["-y","serena-slim"]}'
+code --add-mcp '{"name":"serena","command":"npx","args":["-y","serena-slim@latest"]}'
 ```
 
 ## Manual Setup
@@ -81,7 +84,7 @@ Add to your `claude_desktop_config.json`:
   "mcpServers": {
     "serena": {
       "command": "npx",
-      "args": ["-y", "serena-slim"]
+      "args": ["-y", "serena-slim@latest"]
     }
   }
 }
@@ -96,7 +99,7 @@ Add to `.cursor/mcp.json` (global) or `<project>/.cursor/mcp.json` (project):
   "mcpServers": {
     "serena": {
       "command": "npx",
-      "args": ["-y", "serena-slim"]
+      "args": ["-y", "serena-slim@latest"]
     }
   }
 }
@@ -121,7 +124,7 @@ MCPSlim acts as a **transparent bridge** between AI models and the original MCP
 │       │                │                      │                 │
 │   Sees 18 grouped      Translates to        Executes actual   │
 │   tools only         original call       tool & returns    │
-│   (~11,655 tokens)                                              │
+│   (~11,874 tokens)                                              │
 └─────────────────────────────────────────────────────────────────┘
 ```
 
@@ -133,7 +136,7 @@ MCPSlim acts as a **transparent bridge** between AI models and the original MCP
 4. **Original MCP executes** — Real server processes the request
 5. **Response returned** — Result passes back unchanged
 
-**Zero functionality loss. 51.2% token savings.**
+**Zero functionality loss. 50.3% token savings.**
 
 ## Available Tool Groups
 

package/index.js

@@ -8,6 +8,7 @@
  *   npx serena-slim --setup            # Auto-configure (interactive)
  *   npx serena-slim --setup claude     # Auto-configure for Claude Desktop
  *   npx serena-slim --setup cursor     # Auto-configure for Cursor
+ *   npx serena-slim --setup claude-code # Auto-configure for Claude Code CLI
  */
 
 const { spawn, execSync } = require('child_process');
@@ -16,7 +17,7 @@ const os = require('os');
 const fs = require('fs');
 const readline = require('readline');
 
-const MCP_NAME = 'serena';
+const MCP_NAME = 'serena-slim';
 const PACKAGE_NAME = 'serena-slim';
 
 // 환경변수 요구사항 (빌드 시 주입)
@@ -116,14 +117,15 @@ async function interactiveSetup() {
     case '3':
       console.log('\nRun this command:\n');
       if (REQUIRED_ENV_VARS.length > 0) {
-        console.log(`  claude mcp add ${MCP_NAME} ${envFlags} -- npx -y ${PACKAGE_NAME}\n`);
+        console.log(`  claude mcp add ${MCP_NAME} -s project ${envFlags} -- npx -y ${PACKAGE_NAME}@latest\n`);
       } else {
-        console.log(`  claude mcp add ${MCP_NAME} -- npx -y ${PACKAGE_NAME}\n`);
+        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}"]${envJson}}'\n`);
+      console.log(`  code --add-mcp '{"name":"${MCP_NAME}","command":"npx","args":["-y","${PACKAGE_NAME}@latest"]${envJson}}'\n`);
       return true;
     case '5':
     default:
@@ -132,17 +134,56 @@ async function interactiveSetup() {
   }
 }
 
+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');
+    console.log('Supported: claude, claude-desktop, cursor, claude-code');
     return false;
   }
 
   const mcpConfig = {
     command: 'npx',
-    args: ['-y', PACKAGE_NAME]
+    args: ['-y', PACKAGE_NAME + '@latest']
   };
 
   // 환경변수가 필요한 경우 env 블록 추가 (플레이스홀더)
@@ -193,7 +234,20 @@ if (setupIndex !== -1) {
   // Normal Mode: Run MCP server
   // ============================================
 
-  const binName = os.platform() === 'win32' ? 'mcpslim.exe' : 'mcpslim';
+  // 플랫폼별 바이너리 이름 결정
+  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', 'serena.json');
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "serena-slim",
-  "version": "0.0.1-slim.1",
-  "description": "Slimmed serena MCP - 38% token reduction for AI models",
+  "version": "0.0.1-slim.1.10",
+  "description": "serena MCP (38% less tokens). Quick setup: npx serena-slim --setup",
   "bin": {
     "serena-slim": "./index.js"
   },
@@ -24,8 +24,7 @@
   ],
   "repository": {
     "type": "git",
-    "url": "https://github.com/palan-k/mcpslim.git",
-    "directory": "packages/serena-slim"
+    "url": "https://github.com/mcpslim/serena-slim.git"
   },
   "mcpslim": {
     "originalPackage": "serena",
@@ -33,5 +32,9 @@
     "originalTools": 29,
     "slimTools": 18,
     "tokenReduction": "38%"
+  },
+  "homepage": "https://mcpslim.github.io/serena-slim",
+  "bugs": {
+    "url": "https://github.com/mcpslim/serena-slim/issues"
   }
-}
+}

package/recipes/serena.json

@@ -4,12 +4,12 @@
   "algorithm_version": "v2.1",
   "rules": {
     "default_minifier": "first_sentence",
-    "remove_params_description": true
+    "remove_params_description": false
   },
   "groups": [
     {
       "name": "read",
-      "description": "Access file contents or relevant memory data to provide contextual information for the current task.",
+      "description": "read operations",
       "mapping": {
         "file": "read_file",
         "memory": "read_memory"
@@ -25,18 +25,22 @@
             ]
           },
           "relative_path": {
-            "type": "string"
+            "type": "string",
+            "description": "relative path to the file to read."
           },
           "start_line": {
             "type": "integer",
-            "default": 0
+            "default": 0,
+            "description": "0-based index of the first line to be retrieved."
           },
           "end_line": {
-            "default": null
+            "default": null,
+            "description": "0-based index of the last line to be retrieved (inclusive)."
           },
           "max_answer_chars": {
             "type": "integer",
-            "default": -1
+            "default": -1,
+            "description": "If the file (chunk) is longer than this number of characters,\nno content will be returned."
           },
           "memory_file_name": {
             "type": "string"
@@ -51,7 +55,7 @@
     },
     {
       "name": "list",
-      "description": "Explore filesystem contents and available memories to locate specific files or data storage.",
+      "description": "list operations",
       "mapping": {
         "dir": "list_dir",
         "memories": "list_memories"
@@ -67,18 +71,22 @@
             ]
           },
           "relative_path": {
-            "type": "string"
+            "type": "string",
+            "description": "relative path to the directory to list; pass \"."
           },
           "recursive": {
-            "type": "boolean"
+            "type": "boolean",
+            "description": "Whether to scan subdirectories recursively."
           },
           "skip_ignored_files": {
             "type": "boolean",
-            "default": false
+            "default": false,
+            "description": "Whether to skip files and directories that are ignored."
           },
           "max_answer_chars": {
             "type": "integer",
-            "default": -1
+            "default": -1,
+            "description": "If the output is longer than this number of characters,\nno content will be returned."
           }
         },
         "required": [
@@ -90,7 +98,7 @@
     },
     {
       "name": "find",
-      "description": "Locate files, discover code symbols, and pinpoint references to specific symbols within a codebase.",
+      "description": "find operations",
       "mapping": {
         "file": "find_file",
         "symbol": "find_symbol",
@@ -108,10 +116,12 @@
             ]
           },
           "file_mask": {
-            "type": "string"
+            "type": "string",
+            "description": "filename or file mask (using the wildcards * or ?"
           },
           "relative_path": {
-            "type": "string"
+            "type": "string",
+            "description": "relative path to the directory to search in; pass \"."
           },
           "name_path_pattern": {
             "type": "string"
@@ -161,7 +171,7 @@
     },
     {
       "name": "replace",
-      "description": "Replace file content via pattern matching or directly substitute the body of identified code symbols.",
+      "description": "replace operations",
       "mapping": {
         "content": "replace_content",
         "symbol_body": "replace_symbol_body"
@@ -177,24 +187,29 @@
             ]
           },
           "relative_path": {
-            "type": "string"
+            "type": "string",
+            "description": "relative path to the file."
           },
           "needle": {
-            "type": "string"
+            "type": "string",
+            "description": "string or regex pattern to search for."
           },
           "repl": {
-            "type": "string"
+            "type": "string",
+            "description": "replacement string (verbatim)."
           },
           "mode": {
             "type": "string",
             "enum": [
               "literal",
               "regex"
-            ]
+            ],
+            "description": "Either \"literal\" or \"regex\", specifying how the `needle` parameter is to be interpreted."
           },
           "allow_multiple_occurrences": {
             "type": "boolean",
-            "default": false
+            "default": false,
+            "description": "If True, the regex may match multiple occurrences in the file\nand all of them will be replaced."
           },
           "name_path": {
             "type": "string"
@@ -216,7 +231,7 @@
     },
     {
       "name": "get",
-      "description": "Analyze code symbols within files and display the agent’s current working configuration details.",
+      "description": "get operations",
       "mapping": {
         "symbols_overview": "get_symbols_overview",
         "current_config": "get_current_config"
@@ -232,15 +247,18 @@
             ]
           },
           "relative_path": {
-            "type": "string"
+            "type": "string",
+            "description": "relative path to the file to get the overview of."
           },
           "depth": {
             "type": "integer",
-            "default": 0
+            "default": 0,
+            "description": "Depth up to which descendants of top-level symbols shall be retrieved\n(e."
           },
           "max_answer_chars": {
             "type": "integer",
-            "default": -1
+            "default": -1,
+            "description": "If the overview is longer than this number of characters,\nno content will be returned."
           }
         },
         "required": [
@@ -251,7 +269,7 @@
     },
     {
       "name": "insert",
-      "description": "Modify code by precisely inserting new content either before or after existing symbol definitions.",
+      "description": "insert operations",
       "mapping": {
         "after_symbol": "insert_after_symbol",
         "before_symbol": "insert_before_symbol"
@@ -267,13 +285,16 @@
             ]
           },
           "name_path": {
-            "type": "string"
+            "type": "string",
+            "description": "Name path of the symbol after which to insert content (definitions in the `find_symbol` tool apply)."
           },
           "relative_path": {
-            "type": "string"
+            "type": "string",
+            "description": "relative path to the file containing the symbol."
           },
           "body": {
-            "type": "string"
+            "type": "string",
+            "description": "body/content to be inserted."
           }
         },
         "required": [
@@ -286,7 +307,7 @@
     },
     {
       "name": "think",
-      "description": "Evaluate gathered information, task progress, and completion status to guide effective AI assistant reasoning.",
+      "description": "think operations",
       "mapping": {
         "about_collected_information": "think_about_collected_information",
         "about_task_adherence": "think_about_task_adherence",
@@ -311,7 +332,7 @@
     },
     {
       "name": "memory",
-      "description": "Manage persistent project knowledge by storing, deleting, and regex-based updating of markdown files.",
+      "description": "memory operations",
       "mapping": {
         "write": "write_memory",
         "delete": "delete_memory",
@@ -374,7 +395,5 @@
     "onboarding",
     "prepare_for_new_conversation",
     "initial_instructions"
-  ],
-  "ai_enhanced": true,
-  "enhanced_at": "2026-01-05T07:32:33.116Z"
+  ]
 }