mcpswitch-cli 0.1.0__tar.gz

mcpswitch_cli-0.1.0/PKG-INFO

@@ -0,0 +1,130 @@
+Metadata-Version: 2.4
+Name: mcpswitch-cli
+Version: 0.1.0
+Summary: Smart MCP profile manager for Claude Code — save 30-40% of your context window
+License: MIT
+Project-URL: Homepage, https://mcpswitch.dev
+Project-URL: Repository, https://github.com/sathibabunaidu58/mcpswitch
+Project-URL: Issues, https://github.com/sathibabunaidu58/mcpswitch/issues
+Keywords: claude,mcp,claude-code,context-window,tokens,llm
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: click>=8.0
+Requires-Dist: rich>=13.0
+Requires-Dist: tiktoken>=0.5
+Provides-Extra: server
+Requires-Dist: flask>=3.0; extra == "server"
+Requires-Dist: requests>=2.31; extra == "server"
+
+# MCPSwitch
+
+**Smart MCP profile manager for Claude Code.**  
+Stop wasting 30-40% of your context window on MCP tools you never use.
+
+---
+
+## The Problem
+
+Every MCP server you install adds its tool schemas to Claude's context window at session start.  
+84 tools across 6 servers = **15,540 tokens consumed before you type a single message.**  
+That's up to 40% of your context window gone — every session, every time.
+
+MCPSwitch lets you define lean profiles for different workflows and switch between them instantly.
+
+---
+
+## Install
+
+```bash
+pip install mcpswitch
+```
+
+Or run from source:
+```bash
+git clone https://github.com/sathibabu/mcpswitch
+cd mcpswitch
+pip install -e .
+```
+
+---
+
+## Quick Start
+
+```bash
+# See what your current MCP config is costing you
+mcpswitch analyze
+
+# Save your current config as a profile
+mcpswitch import --name full
+
+# Create a lean profile
+mcpswitch create python-backend
+
+# Add only the servers you need for Python work
+mcpswitch add python-backend github
+mcpswitch add python-backend context7
+
+# Switch to it before starting a Claude Code session
+mcpswitch use python-backend
+
+# See all profiles and their token costs
+mcpswitch list
+```
+
+---
+
+## Commands
+
+| Command | What it does |
+|---------|-------------|
+| `mcpswitch status` | Show active profile + token cost of loaded servers |
+| `mcpswitch analyze` | Break down token cost by server, show savings potential |
+| `mcpswitch list` | List all profiles with token estimates |
+| `mcpswitch use <profile>` | Switch to a profile (rewrites Claude config) |
+| `mcpswitch import --name <n>` | Save current config as a named profile |
+| `mcpswitch create <profile>` | Create a new empty profile |
+| `mcpswitch add <profile> <server>` | Add a server to a profile |
+| `mcpswitch remove <profile> <server>` | Remove a server from a profile |
+| `mcpswitch save <profile>` | Save current active config as profile |
+| `mcpswitch delete <profile>` | Delete a profile |
+
+---
+
+## Real-World Savings
+
+| Scenario | All MCPs | Lean Profile | Saved |
+|----------|----------|-------------|-------|
+| Python backend work | 15,540 tokens | 3,200 tokens | 12,340 tokens (79%) |
+| Frontend work | 15,540 tokens | 4,100 tokens | 11,440 tokens (74%) |
+| Writing/docs | 15,540 tokens | 900 tokens | 14,640 tokens (94%) |
+
+Fewer wasted tokens = more context for your actual code = better Claude responses.
+
+---
+
+## How It Works
+
+MCPSwitch reads and writes the Claude MCP config files:
+- **Claude Code CLI**: `~/.claude/claude_desktop_config.json`
+- **Claude Desktop**: `~/AppData/Roaming/Claude/claude_desktop_config.json` (Windows)
+
+Profiles are stored in `~/.mcpswitch/profiles.json`. Every config change is backed up automatically before overwriting.
+
+---
+
+## Pricing
+
+- **Free**: unlimited profiles, all commands, open source
+- **Pro** ($19/month): coming soon — auto-detect project type and switch profiles automatically, usage analytics, team profile sharing
+
+---
+
+## License
+
+MIT

mcpswitch_cli-0.1.0/README.md

@@ -0,0 +1,106 @@
+# MCPSwitch
+
+**Smart MCP profile manager for Claude Code.**  
+Stop wasting 30-40% of your context window on MCP tools you never use.
+
+---
+
+## The Problem
+
+Every MCP server you install adds its tool schemas to Claude's context window at session start.  
+84 tools across 6 servers = **15,540 tokens consumed before you type a single message.**  
+That's up to 40% of your context window gone — every session, every time.
+
+MCPSwitch lets you define lean profiles for different workflows and switch between them instantly.
+
+---
+
+## Install
+
+```bash
+pip install mcpswitch
+```
+
+Or run from source:
+```bash
+git clone https://github.com/sathibabu/mcpswitch
+cd mcpswitch
+pip install -e .
+```
+
+---
+
+## Quick Start
+
+```bash
+# See what your current MCP config is costing you
+mcpswitch analyze
+
+# Save your current config as a profile
+mcpswitch import --name full
+
+# Create a lean profile
+mcpswitch create python-backend
+
+# Add only the servers you need for Python work
+mcpswitch add python-backend github
+mcpswitch add python-backend context7
+
+# Switch to it before starting a Claude Code session
+mcpswitch use python-backend
+
+# See all profiles and their token costs
+mcpswitch list
+```
+
+---
+
+## Commands
+
+| Command | What it does |
+|---------|-------------|
+| `mcpswitch status` | Show active profile + token cost of loaded servers |
+| `mcpswitch analyze` | Break down token cost by server, show savings potential |
+| `mcpswitch list` | List all profiles with token estimates |
+| `mcpswitch use <profile>` | Switch to a profile (rewrites Claude config) |
+| `mcpswitch import --name <n>` | Save current config as a named profile |
+| `mcpswitch create <profile>` | Create a new empty profile |
+| `mcpswitch add <profile> <server>` | Add a server to a profile |
+| `mcpswitch remove <profile> <server>` | Remove a server from a profile |
+| `mcpswitch save <profile>` | Save current active config as profile |
+| `mcpswitch delete <profile>` | Delete a profile |
+
+---
+
+## Real-World Savings
+
+| Scenario | All MCPs | Lean Profile | Saved |
+|----------|----------|-------------|-------|
+| Python backend work | 15,540 tokens | 3,200 tokens | 12,340 tokens (79%) |
+| Frontend work | 15,540 tokens | 4,100 tokens | 11,440 tokens (74%) |
+| Writing/docs | 15,540 tokens | 900 tokens | 14,640 tokens (94%) |
+
+Fewer wasted tokens = more context for your actual code = better Claude responses.
+
+---
+
+## How It Works
+
+MCPSwitch reads and writes the Claude MCP config files:
+- **Claude Code CLI**: `~/.claude/claude_desktop_config.json`
+- **Claude Desktop**: `~/AppData/Roaming/Claude/claude_desktop_config.json` (Windows)
+
+Profiles are stored in `~/.mcpswitch/profiles.json`. Every config change is backed up automatically before overwriting.
+
+---
+
+## Pricing
+
+- **Free**: unlimited profiles, all commands, open source
+- **Pro** ($19/month): coming soon — auto-detect project type and switch profiles automatically, usage analytics, team profile sharing
+
+---
+
+## License
+
+MIT

mcpswitch_cli-0.1.0/mcpswitch/__init__.py

@@ -0,0 +1,3 @@
+"""MCPSwitch — smart MCP profile manager for Claude Code."""
+
+__version__ = "0.1.0"

mcpswitch_cli-0.1.0/mcpswitch/auto.py

@@ -0,0 +1,353 @@
+"""Context-aware automatic profile selection.
+
+How it works:
+1. Read conversation context from ~/.claude/history.jsonl (last N messages)
+2. Scan project directory for tech stack signals
+3. Score each profile against detected context
+4. Switch to the best match — silently if confident, ask if not
+
+This runs at session start via: mcpswitch auto
+Or manually: mcpswitch auto --dir /path/to/project
+"""
+
+import json
+import os
+import re
+from pathlib import Path
+from typing import Optional
+
+from .profiles import load_profiles, get_active_profile, set_active_profile
+from .config import get_claude_code_config_path, set_mcp_servers
+from .tokens import estimate_total_tokens
+
+# ── Tech stack signals → MCP server names ────────────────────────────────────
+
+# File presence signals: if these files exist, these servers are likely needed
+FILE_SIGNALS: list[tuple[str, list[str]]] = [
+    # (glob pattern, [relevant mcp server names])
+    ("package.json",           ["github", "playwright", "context7"]),
+    ("requirements.txt",       ["github", "context7", "postgres"]),
+    ("pyproject.toml",         ["github", "context7", "postgres"]),
+    ("go.mod",                 ["github", "context7"]),
+    ("Cargo.toml",             ["github", "context7"]),
+    ("docker-compose.yml",     ["github", "postgres", "sqlite"]),
+    (".github/workflows/*.yml",["github"]),
+    ("prisma/schema.prisma",   ["github", "postgres"]),
+    ("supabase/**",            ["github", "postgres"]),
+    ("*.test.*",               ["playwright", "github"]),
+    ("playwright.config.*",    ["playwright"]),
+    ("*.md",                   ["filesystem", "fetch"]),
+    ("docs/**",                ["filesystem", "fetch"]),
+]
+
+# Conversation keyword signals: words in recent messages → relevant servers
+KEYWORD_SIGNALS: dict[str, list[str]] = {
+    # Code & git
+    "pull request":   ["github"],
+    "pr review":      ["github"],
+    "github":         ["github"],
+    "commit":         ["github"],
+    "branch":         ["github"],
+    "merge":          ["github"],
+
+    # Browser / frontend
+    "browser":        ["playwright"],
+    "screenshot":     ["playwright"],
+    "click":          ["playwright"],
+    "scrape":         ["playwright"],
+    "selenium":       ["playwright"],
+    "test":           ["playwright", "github"],
+
+    # Search
+    "search":         ["brave-search"],
+    "google":         ["brave-search"],
+    "find online":    ["brave-search"],
+    "look up":        ["brave-search"],
+
+    # Database
+    "database":       ["postgres", "sqlite"],
+    "sql":            ["postgres", "sqlite"],
+    "postgres":       ["postgres"],
+    "sqlite":         ["sqlite"],
+    "query":          ["postgres", "sqlite"],
+
+    # Docs / files
+    "documentation":  ["filesystem", "context7"],
+    "readme":         ["filesystem"],
+    "file":           ["filesystem"],
+    "read file":      ["filesystem"],
+
+    # API docs
+    "api docs":       ["context7"],
+    "documentation":  ["context7"],
+    "latest docs":    ["context7"],
+    "how to use":     ["context7"],
+
+    # Notes / knowledge
+    "obsidian":       ["obsidian"],
+    "notes":          ["obsidian"],
+    "vault":          ["obsidian"],
+}
+
+CONFIDENCE_THRESHOLD = 0.4  # switch silently above this, ask below
+
+
+def _read_recent_history(n_messages: int = 20) -> str:
+    """Read the last N messages from Claude Code history.
+
+    Returns concatenated text of recent user messages.
+    """
+    history_file = Path.home() / ".claude" / "history.jsonl"
+    if not history_file.exists():
+        return ""
+
+    lines = []
+    try:
+        with open(history_file, "r", encoding="utf-8") as f:
+            lines = f.readlines()
+    except Exception:
+        return ""
+
+    messages = []
+    for line in reversed(lines[-200:]):  # look at last 200 lines max
+        try:
+            entry = json.loads(line.strip())
+            # Extract user message text
+            if isinstance(entry, dict):
+                content = entry.get("message", "") or entry.get("content", "")
+                if isinstance(content, list):
+                    for block in content:
+                        if isinstance(block, dict) and block.get("type") == "text":
+                            messages.append(block.get("text", ""))
+                elif isinstance(content, str):
+                    messages.append(content)
+        except Exception:
+            continue
+        if len(messages) >= n_messages:
+            break
+
+    return " ".join(messages).lower()
+
+
+def _scan_project_signals(directory: str) -> list[str]:
+    """Scan directory for tech stack files. Returns list of relevant MCP server names."""
+    path = Path(directory)
+    if not path.exists():
+        return []
+
+    relevant_servers = []
+    for pattern, servers in FILE_SIGNALS:
+        if "**" in pattern or "*" in pattern:
+            matches = list(path.glob(pattern))
+        else:
+            matches = [path / pattern] if (path / pattern).exists() else []
+
+        if matches:
+            relevant_servers.extend(servers)
+
+    return list(set(relevant_servers))
+
+
+def _score_profile(
+    profile_name: str,
+    profile_servers: dict,
+    context_servers: list[str],
+    conversation_servers: list[str],
+) -> float:
+    """Score a profile 0.0–1.0 based on how well it matches detected context.
+
+    Higher = better match.
+    """
+    if not profile_servers:
+        return 0.0
+
+    loaded = set(profile_servers.keys())
+    needed = set(context_servers + conversation_servers)
+
+    if not needed:
+        return 0.0
+
+    # Coverage: what % of needed servers does this profile have?
+    coverage = len(loaded & needed) / len(needed)
+
+    # Precision: what % of loaded servers are actually needed? (penalize bloat)
+    precision = len(loaded & needed) / len(loaded) if loaded else 0.0
+
+    # Weighted: coverage matters more than precision
+    score = (coverage * 0.7) + (precision * 0.3)
+    return round(score, 3)
+
+
+def select_best_profile(
+    directory: Optional[str] = None,
+    conversation_text: Optional[str] = None,
+) -> dict:
+    """Select the best profile for current context.
+
+    Returns:
+    {
+        "recommended": str,      # profile name
+        "confidence": float,     # 0.0 - 1.0
+        "reason": str,           # human-readable explanation
+        "scores": {name: score}, # all profile scores
+        "context_servers": [...],# servers detected from project
+        "conversation_servers":[],# servers detected from conversation
+        "current_profile": str,
+    }
+    """
+    profiles = load_profiles()
+    current = get_active_profile()
+
+    if not profiles:
+        return {
+            "recommended": None,
+            "confidence": 0.0,
+            "reason": "No profiles configured. Run: mcpswitch import --name <name>",
+            "scores": {},
+            "context_servers": [],
+            "conversation_servers": [],
+            "current_profile": current,
+        }
+
+    # 1. Detect from project files
+    project_dir = directory or os.getcwd()
+    context_servers = _scan_project_signals(project_dir)
+
+    # 2. Detect from conversation history
+    if conversation_text is None:
+        conversation_text = _read_recent_history(20)
+
+    conversation_servers = []
+    for keyword, servers in KEYWORD_SIGNALS.items():
+        if keyword in conversation_text:
+            conversation_servers.extend(servers)
+    conversation_servers = list(set(conversation_servers))
+
+    # 3. Score all profiles
+    scores = {}
+    for name, servers in profiles.items():
+        scores[name] = _score_profile(name, servers, context_servers, conversation_servers)
+
+    if not any(scores.values()):
+        # No signals detected — recommend the profile with fewest tokens (lean default)
+        config_path = get_claude_code_config_path()
+        best = min(profiles.keys(), key=lambda n: estimate_total_tokens(profiles[n])["total"])
+        return {
+            "recommended": best,
+            "confidence": 0.2,
+            "reason": "No project signals detected. Recommending leanest profile.",
+            "scores": scores,
+            "context_servers": context_servers,
+            "conversation_servers": conversation_servers,
+            "current_profile": current,
+        }
+
+    best = max(scores, key=lambda k: scores[k])
+    confidence = scores[best]
+
+    # Build reason string
+    reason_parts = []
+    if context_servers:
+        reason_parts.append(f"project signals: {', '.join(context_servers[:3])}")
+    if conversation_servers:
+        reason_parts.append(f"conversation context: {', '.join(conversation_servers[:3])}")
+    reason = "Detected " + " | ".join(reason_parts) if reason_parts else "Best available match"
+
+    return {
+        "recommended": best,
+        "confidence": confidence,
+        "current_profile": current,
+        "scores": scores,
+        "context_servers": context_servers,
+        "conversation_servers": conversation_servers,
+        "reason": reason,
+    }
+
+
+def auto_switch(
+    directory: Optional[str] = None,
+    confirm_threshold: float = CONFIDENCE_THRESHOLD,
+    force: bool = False,
+    silent: bool = False,
+) -> dict:
+    """Auto-select and switch profile based on context.
+
+    Returns:
+    {
+        "switched": bool,
+        "from_profile": str,
+        "to_profile": str,
+        "confidence": float,
+        "needs_confirmation": bool,  # True if confidence below threshold
+        "reason": str,
+    }
+    """
+    result = select_best_profile(directory=directory)
+    recommended = result["recommended"]
+    confidence = result["confidence"]
+    current = result["current_profile"]
+
+    if not recommended:
+        return {
+            "switched": False,
+            "from_profile": current,
+            "to_profile": None,
+            "confidence": 0.0,
+            "needs_confirmation": False,
+            "reason": result["reason"],
+        }
+
+    # Already on the best profile
+    if recommended == current and not force:
+        return {
+            "switched": False,
+            "from_profile": current,
+            "to_profile": recommended,
+            "confidence": confidence,
+            "needs_confirmation": False,
+            "reason": f"Already on best profile '{current}'",
+        }
+
+    # Low confidence — ask user
+    if confidence < confirm_threshold and not force:
+        return {
+            "switched": False,
+            "from_profile": current,
+            "to_profile": recommended,
+            "confidence": confidence,
+            "needs_confirmation": True,
+            "reason": result["reason"],
+        }
+
+    # High confidence — switch silently
+    from .profiles import get_profile
+    from .config import get_claude_desktop_config_path
+
+    servers = get_profile(recommended)
+    if not servers and servers != {}:
+        return {
+            "switched": False,
+            "from_profile": current,
+            "to_profile": recommended,
+            "confidence": confidence,
+            "needs_confirmation": False,
+            "reason": f"Profile '{recommended}' not found",
+        }
+
+    config_path = get_claude_code_config_path()
+    set_mcp_servers(config_path, servers)
+
+    desktop_path = get_claude_desktop_config_path()
+    if desktop_path and desktop_path.exists():
+        set_mcp_servers(desktop_path, servers)
+
+    set_active_profile(recommended)
+
+    return {
+        "switched": True,
+        "from_profile": current,
+        "to_profile": recommended,
+        "confidence": confidence,
+        "needs_confirmation": False,
+        "reason": result["reason"],
+    }