kimi-mcp-hub 0.1.0

package/README.md

@@ -0,0 +1,390 @@
+# Kimi MCP Hub
+
+One-click MCP server and skills manager for **Kimi CLI** -- like `claude-mem` but for connecting 23 MCP servers (Jira, GitHub, Slack, Datadog, Perplexity, Stripe, GitLab, DBHub, etc.), 34 AI skills (6 core + 28 optional), persistent memory, and Claude Desktop import.
+
+---
+
+## Table of Contents
+
+- [Install](#install)
+  - [One-liner (no clone)](#one-liner-no-clone)
+  - [From GitHub (pip)](#from-github-pip)
+  - [Clone + Install](#clone--install)
+  - [Verify](#verify)
+- [Uninstall](#uninstall)
+- [Quick Start](#quick-start)
+- [OAuth Auto-Browser](#oauth-auto-browser)
+- [All Commands](#all-commands)
+- [MCP Servers](#17-mcp-servers)
+- [Skills](#34-skills)
+- [Architecture](#architecture)
+- [Ideas from Claude-Mem](#-ideas-from-claude-mem)
+
+---
+
+## Install
+
+### One-liner with npx (recommended)
+
+```bash
+# macOS / Linux / Windows
+npx kimi-mcp-hub install
+```
+
+This creates an isolated Python virtual environment in `~/.kimi-mcp-hub/venv`, installs the package, and runs the interactive setup wizard.
+
+### One-liner (curl / PowerShell)
+
+```bash
+# macOS / Linux (curl + pip from GitHub)
+curl -fsSL https://raw.githubusercontent.com/KalimeroMK/kimi-mcp-hub/main/install/install.sh | bash
+
+# Windows (PowerShell)
+iwr -useb https://raw.githubusercontent.com/KalimeroMK/kimi-mcp-hub/main/install/install.ps1 | iex
+```
+
+### From GitHub (pip)
+
+```bash
+# Direct from GitHub -- no clone needed
+pip install --user git+https://github.com/KalimeroMK/kimi-mcp-hub.git
+
+# Upgrade
+pip install --user --upgrade git+https://github.com/KalimeroMK/kimi-mcp-hub.git
+```
+
+### From PyPI (when published)
+
+```bash
+pip install --user kimi-mcp-hub
+```
+
+### Clone + Install (development)
+
+```bash
+git clone https://github.com/KalimeroMK/kimi-mcp-hub.git
+cd kimi-mcp-hub
+pip install -e .
+```
+
+### Requirements
+
+- **Python** 3.10+
+- **Node.js** + **npm/npx** (for MCP servers that need it)
+- **Kimi CLI** installed
+- Optional: **Docker** (for some servers)
+
+### Verify
+
+```bash
+kimi-mcp-hub --version
+# -> kimi-mcp-hub, version 0.1.0
+```
+
+On first run you'll see:
+
+```
+Kimi MCP Hub v0.1.0 e uspeshno instaliran!
+
+23 MCP serveri dostapni
+34 AI skills za podobro kodiranje
+1  Persistent memory sistem
+
+Za da zapochnesh:
+  kimi-mcp-hub init    -- interaktiven wizard
+  kimi-mcp-hub welcome -- detalen pregled
+  kimi-mcp-hub status  -- status proverka
+  kimi-mcp-hub doctor  -- zdravje na sistemot
+```
+
+### Run the wizard
+
+```bash
+kimi-mcp-hub init
+```
+
+This walks you through:
+1. **MCP Servers** -- pick which services to connect
+2. **Skills** -- install AI behavior patterns
+3. **Memory** -- enable persistent cross-session memory
+
+---
+
+## Uninstall
+
+```bash
+# Full reset
+pip uninstall kimi-mcp-hub
+rm -f ~/.kimi/mcp.json
+rm -rf ~/.kimi/skills/
+rm -rf ~/.kimi/mcp-hub/
+rm -rf ~/.config/kimi-mcp-hub/
+
+# Or use the CLI
+kimi-mcp-hub remove jira      # remove one server
+kimi-mcp-hub remove github    # remove another
+```
+
+**Complete reinstall:**
+
+```bash
+pip uninstall kimi-mcp-hub
+rm -rf ~/.kimi/mcp.json ~/.kimi/skills/ ~/.kimi/mcp-hub/
+pip install --user git+https://github.com/KalimeroMK/kimi-mcp-hub.git
+kimi-mcp-hub init
+```
+
+---
+
+## Quick Start
+
+```bash
+# Show welcome banner + status
+kimi-mcp-hub
+
+# Check system health
+kimi-mcp-hub doctor
+
+# Full interactive setup
+kimi-mcp-hub init
+
+# Add servers individually
+kimi-mcp-hub add jira
+kimi-mcp-hub add github
+kimi-mcp-hub add perplexity
+kimi-mcp-hub add gitlab
+kimi-mcp-hub add stripe
+kimi-mcp-hub add figma-context
+kimi-mcp-hub add desktop-commander
+kimi-mcp-hub add dbhub
+kimi-mcp-hub add mobile
+
+# Or use npx without installing Node package globally:
+# npx kimi-mcp-hub status
+
+# Auth with auto-browser (OAuth) -- like Claude Code CLI
+kimi-mcp-hub auth github
+kimi-mcp-hub auth slack
+kimi-mcp-hub auth figma
+kimi-mcp-hub auth gitlab
+kimi-mcp-hub auth stripe
+
+# See everything configured
+kimi-mcp-hub list
+kimi-mcp-hub status
+kimi-mcp-hub welcome
+
+# Import from Claude Desktop
+kimi-mcp-hub import-claude
+
+# Manage skills
+kimi-mcp-hub list-skills
+kimi-mcp-hub install-skill docker-pro
+
+# Test a server
+kimi-mcp-hub test github
+```
+
+---
+
+## OAuth Auto-Browser
+
+Like Claude Code CLI, `kimi-mcp-hub` automatically opens your browser for OAuth:
+
+```bash
+$ kimi-mcp-hub auth github
+
+> Github Authorization
+  Auto-browser mode (like Claude Code CLI)
+
+  Method: Device Flow -- auto browser + code
+
+Your verification code: ABCD-1234
+Opening browser...
+
+If browser didn't open:
+1. Go to: https://github.com/login/device
+2. Enter code: ABCD-1234
+3. Click 'Authorize'
+
+Waiting for you to authorize in browser...
+
+GitHub authorized successfully!
+```
+
+| Server | Method | Auto-browser |
+|--------|--------|:------------:|
+| **GitHub** | Device Flow (or PAT fallback) | Yes |
+| **Jira** | API Token or Official MCP OAuth | Yes |
+| **Confluence** | API Token or Official MCP OAuth | Yes |
+| **Slack** | Bot Token or OAuth 2.0 | Yes |
+| **Figma** | Official OAuth 2.1, PAT or custom OAuth 2.0 | Yes* |
+| **Gmail** | Google OAuth 2.0 or npx | Yes |
+| **Linear** | Official OAuth 2.1 or API key | Yes* |
+| **Stripe** | Official OAuth 2.1 or restricted API key | Yes* |
+| **GitLab** | Official OAuth 2.1 or PAT | Yes* |
+| **Datadog** | API + App keys | No (manual) |
+
+\* Linear/Figma/Stripe/GitLab OAuth 2.1 се иницира од Kimi CLI (`kimi mcp auth <server>`) откако ќе го додадете официјалниот remote MCP сервер.
+
+---
+
+## All Commands
+
+| Command | Description |
+|---------|-------------|
+| `kimi-mcp-hub` | Show welcome banner and status |
+| `kimi-mcp-hub --version` | Show version |
+| `kimi-mcp-hub install` | Install/update from PyPI/GitHub |
+| `kimi-mcp-hub init` | Full interactive wizard |
+| `kimi-mcp-hub status` | Version, servers, skills, memory |
+| `kimi-mcp-hub welcome` | Detailed welcome banner |
+| `kimi-mcp-hub add <server>` | Add an MCP server |
+| `kimi-mcp-hub remove <server>` | Remove an MCP server |
+| `kimi-mcp-hub auth <server>` | OAuth with auto-browser |
+| `kimi-mcp-hub import-claude` | Import from Claude Desktop |
+| `kimi-mcp-hub list` | All servers + skills + memory |
+| `kimi-mcp-hub list-skills` | All 34 available skills |
+| `kimi-mcp-hub install-skill <name>` | Install a skill |
+| `kimi-mcp-hub test <server>` | Test if server responds |
+| `kimi-mcp-hub doctor` | System health check |
+
+---
+
+## 23 MCP Servers
+
+| Server | Auth | Tools | Best for |
+|--------|------|:-----:|----------|
+| **Jira** | OAuth (Cloud) or API token | 8 | Tickets, sprints, worklogs |
+| **Linear** | Official OAuth 2.1 or API key | 6 | Issues, projects, teams |
+| **Confluence** | OAuth or API token | 5 | Docs, wiki, pages |
+| **GitHub** | Device Flow / PAT | 6 | Repos, PRs, issues, code |
+| **Slack** | OAuth or token | 7 | Channels, DMs, search |
+| **Datadog** | API + App keys | 12 | Metrics, logs, monitors, APM |
+| **Figma** | Official OAuth 2.1, PAT or custom OAuth | 9 | Designs, tokens, components |
+| **Figma Context** | Figma API access token | 3 | Design-to-code implementation |
+| **GitLab** | Official OAuth 2.1 or PAT | 8 | Repos, MRs, issues, CI/CD pipelines |
+| **Gmail** | OAuth (npx), Chrome bridge, or Python SDK | 8 | Read, search, send emails |
+| **HubSpot** | Private App token | 9 | CRM contacts, deals, companies |
+| **Stripe** | Official OAuth 2.1 or restricted API key | 8 | Payments, customers, subscriptions, invoices |
+| **Desktop Commander** | STDIO (npx/Docker) | 8 | Terminal commands, file ops, process management |
+| **DBHub** | DSN string (read-only optional) | 2 | Multi-database gateway (PG, MySQL, SQLite, etc.) |
+| **Mobile MCP** | STDIO (npx) | 9 | iOS/Android automation on simulators and real devices |
+| **Grain** | Browser automation | 2 | Meeting transcripts |
+| **Chrome DevTools** | STDIO (Node 22+ required) | 10 | Performance, network, screenshots, console |
+| **PostgreSQL** | DSN string | 6 | SQL queries, schema, slow query analysis |
+| **Playwright** | STDIO (Node.js) | 8 | Browser automation, E2E testing, screenshots |
+| **Sentry** | Auth token + org | 6 | Error tracking, issue triage, stack traces |
+| **Context7** | STDIO (npx) | 4 | Live library docs, version-aware API lookup |
+| **Supabase** | URL + API key | 6 | Database, auth, storage, realtime, edge functions |
+| **Perplexity** | **API key (free tier)** | **3** | **Real-time web search with AI summaries + citations** |
+
+---
+
+## 34 Skills
+
+### Core Skills (installed by default)
+
+| Skill | Description | Trigger |
+|-------|-------------|---------|
+| **karpathy** | Clean, simple, readable code | Any code generation |
+| **superpowers** | 14 agentic dev skills (plan, debug, test, deploy...) | "plan", "debug", "architect" |
+| **headroom** | Compress tool outputs (save tokens) | Large outputs, "compress" |
+| **context-mode** | Context window optimization | "context limit", "token budget" |
+| **cybersecurity** | Security expert (OWASP, cloud, IR, pentest) | "security", "hack", "OWASP" |
+| **kimi-mcp-hub-status** | Shows MCP Hub version/status in Kimi CLI | Session start |
+
+### Optional Skills
+
+| Skill | Description | Trigger |
+|-------|-------------|---------|
+| **caveman** | Terse mode (75% token reduction) | "caveman", "terse", "brief" |
+| **ecc** | Engineering Competence (perf, security, research) | "optimize", "secure", "research" |
+| **ui-ux-pro-max** | Design intelligence (Tailwind, accessibility) | "design", "UI", "CSS" |
+| **visual-explainer** | HTML diagrams and slides | "visualize", "diagram" |
+| **task-master** | Task management system | "task", "todo", "backlog" |
+| **gitnexus** | Code knowledge graph (git blame, blast radius) | "who wrote this", "impact" |
+| **ralph** | Autonomous loop with stop-hooks | "keep going", "continue" |
+| **security-audit** | Security review checklist | "security", "audit", "vulnerability" |
+| **security-guidance** | 3-layer security scanning (Anthropic-style) | File edits, "security scan" |
+| **research-mode** | Research-driven development | "research", "compare", "benchmark" |
+| **perf-optimization** | Performance profiling and fixes | "slow", "profile", "benchmark" |
+| **memory-palace** | Advanced context management | "remember", "previous session" |
+| **code-reviewer** | Code review assistant | "review", "CR", "feedback" |
+| **code-review-anthropic** | Multi-agent PR review (sub-agents) | "PR review", "deep review" |
+| **api-designer** | REST/GraphQL API design | "API", "endpoint", "REST" |
+| **docker-pro** | Docker and Kubernetes best practices | "docker", "container", "k8s" |
+| **database-expert** | Database design and optimization | "database", "SQL", "schema" |
+| **backend-architect** | Backend architecture (API, DB, scale) | "design API", "system design" |
+| **python-engineer** | Python specialist (FastAPI, Django, async) | "Python", "FastAPI", "Django" |
+| **react-coder** | React 19 specialist (RSC, hooks) | "React", "component", "Next.js" |
+| **ts-coder** | TypeScript specialist (strict, generics) | "TypeScript", "TS", "generic" |
+| **ui-engineer** | UI/UX engineer (Tailwind, a11y, responsive) | "UI", "Tailwind", "responsive" |
+| **laravel-engineer** | Laravel specialist (Eloquent, Blade, Livewire, Queues) | "Laravel", "Eloquent", "PHP" |
+| **find-skills** | Discover and install agent skills from the open ecosystem | "find skill", "install skill" |
+
+---
+
+## Ideas from Claude-Mem
+
+Features we adopted from the 81k-star `claude-mem` project:
+
+| Feature | Claude-Mem | Kimi MCP Hub |
+|---------|-----------|-------------|
+| **One-line install** | `npx claude-mem install` | `curl .../install.sh \| bash` |
+| **Auto-detect CLI** | `--ide gemini-cli`, `--ide opencode` | Auto-detect `kimi` CLI |
+| **Persistent memory** | AI-compressed observations | SQLite + FTS5 |
+| **Web viewer UI** | `http://localhost:37777` | Coming soon |
+| **Skills / memory search** | `mem-search` skill | Built-in `memory_palace` skill |
+| **Privacy tags** | `<private>` content exclusion | Planned |
+| **Plugin hooks** | `.claude/`, `.codex/` hooks | `~/.kimi/skills/` directory |
+| **Import from other tools** | - | Claude Desktop import |
+
+---
+
+## Architecture
+
+```
++-----------------------------------------+
+|         kimi-mcp-hub CLI                |
+|  +---------------------------------+    |
+|  |  (no args) -> welcome banner    |    |
+|  |  install -> PyPI/GitHub update  |    |
+|  |  init -> interactive wizard     |    |
+|  |  add  -> writes ~/.kimi/mcp.json|    |
+|  |  auth -> OAuth + auto browser   |    |
+|  |  import-claude -> migrate config|    |
+|  |  list -> pretty table of tools  |    |
+|  |  status -> version + health     |    |
+|  |  welcome -> full info display   |    |
+|  +---------------------------------+    |
+|              |                          |
+|  +---------------------------------+    |
+|  |  ~/.kimi/mcp.json               |    |
+|  |  ~/.kimi-code/skills/ (34 skills) |    |
+|  |  ~/.kimi/mcp-hub/memory.db      |    |
+|  +---------------------------------+    |
+|              |                          |
+|  First-run welcome message (auto)       |
+|              |                          |
+|         Kimi CLI reads config           |
+|              |                          |
+|         /mcp shows tools                |
+|         Skills auto-activate            |
+|         Memory persists context         |
++-----------------------------------------+
+```
+
+---
+
+## Security Notes
+
+- OAuth tokens are stored as plain JSON in `~/.config/kimi-mcp-hub/tokens.json`. This keeps the tool dependency-free, but means anyone with access to your user account can read them.
+- By default GitHub authentication uses a public OAuth app (`kimi-mcp-hub`). You can supply your own GitHub/Atlassian OAuth Client ID when running `kimi-mcp-hub auth <server>`.
+- API keys and PATs are written to `~/.kimi/mcp.json`. Protect that file accordingly.
+
+---
+
+## License
+
+MIT

package/install/install.ps1

@@ -0,0 +1,92 @@
+# Kimi MCP Hub - One-line installer for Windows (PowerShell)
+# Usage: iwr -useb https://raw.githubusercontent.com/KalimeroMK/kimi-mcp-hub/main/install/install.ps1 | iex
+
+$REPO = "KalimeroMK/kimi-mcp-hub"
+$INSTALL_DIR = if ($env:KIMI_MCP_HUB_DIR) { $env:KIMI_MCP_HUB_DIR } else { "$env:USERPROFILE\.kimi-mcp-hub" }
+
+function Write-Header {
+    Write-Host ""
+    Write-Host "  KIMI MCP HUB" -ForegroundColor Cyan -NoNewline
+    Write-Host " - One-click MCP server & skills manager" -ForegroundColor Gray
+    Write-Host "  23 MCP Servers | 34 AI Skills | Persistent Memory" -ForegroundColor DarkGray
+    Write-Host ""
+}
+
+function Check-Requirements {
+    Write-Host "Checking requirements..." -ForegroundColor Cyan
+    
+    # Check Python
+    if (Get-Command python -ErrorAction SilentlyContinue) {
+        $pyVersion = (python --version 2>&1).ToString().Split()[1]
+        Write-Host "  Python $pyVersion found" -ForegroundColor Green
+    } elseif (Get-Command python3 -ErrorAction SilentlyContinue) {
+        $pyVersion = (python3 --version 2>&1).ToString().Split()[1]
+        Write-Host "  Python $pyVersion found" -ForegroundColor Green
+    } else {
+        Write-Host "  Python 3.10+ is required. Install from https://python.org/downloads" -ForegroundColor Red
+        exit 1
+    }
+    
+    # Check pip
+    if (python -m pip --version -ErrorAction SilentlyContinue) {
+        Write-Host "  pip found" -ForegroundColor Green
+    } else {
+        Write-Host "  pip not found. Run: python -m ensurepip --upgrade" -ForegroundColor Red
+        exit 1
+    }
+    
+    # Check Node.js (optional)
+    if (Get-Command node -ErrorAction SilentlyContinue) {
+        $nodeVersion = (node --version 2>$null)
+        Write-Host "  Node.js $nodeVersion found" -ForegroundColor Green
+    } else {
+        Write-Host "  Node.js not found (needed for some MCP servers)" -ForegroundColor Yellow
+    }
+}
+
+function Install-FromGitHub {
+    Write-Host "Installing from GitHub..." -ForegroundColor Cyan
+    
+    # Remove old install if exists
+    if (Test-Path $INSTALL_DIR) {
+        Remove-Item -Recurse -Force $INSTALL_DIR
+    }
+    
+    git clone --depth 1 "https://github.com/$REPO.git" $INSTALL_DIR
+    Write-Host "  Cloned to $INSTALL_DIR" -ForegroundColor Green
+    
+    Set-Location $INSTALL_DIR
+    python -m pip install --upgrade --user -e .
+    Write-Host "  Package installed" -ForegroundColor Green
+}
+
+function Install-PipGit {
+    Write-Host "Installing directly from GitHub (pip)..." -ForegroundColor Cyan
+    python -m pip install --upgrade --user "git+https://github.com/$REPO.git"
+    Write-Host "  Installed from GitHub" -ForegroundColor Green
+}
+
+function Show-Welcome {
+    Write-Host ""
+    Write-Host "Kimi MCP Hub installed successfully!" -ForegroundColor Green
+    Write-Host ""
+    Write-Host "Quick start:" -ForegroundColor Cyan
+    Write-Host "  kimi-mcp-hub init      # Run interactive setup wizard"
+    Write-Host "  kimi-mcp-hub status    # Check installation status"
+    Write-Host "  kimi-mcp-hub doctor    # Check system health"
+    Write-Host ""
+    Write-Host "Add your first server:" -ForegroundColor Cyan
+    Write-Host "  kimi-mcp-hub add github"
+    Write-Host "  kimi-mcp-hub auth github  # Auto-browser OAuth"
+    Write-Host ""
+    Write-Host "Use in Kimi CLI:" -ForegroundColor Cyan
+    Write-Host "  /mcp       # List available tools"
+    Write-Host "  /skills    # List installed skills"
+    Write-Host ""
+}
+
+# Main
+Write-Header
+Check-Requirements
+Install-PipGit
+Show-Welcome

package/install/install.sh

@@ -0,0 +1,231 @@
+#!/usr/bin/env bash
+# Kimi MCP Hub - One-line installer
+# Usage: curl -fsSL https://raw.githubusercontent.com/KalimeroMK/kimi-mcp-hub/main/install/install.sh | bash
+
+set -e
+
+REPO="KalimeroMK/kimi-mcp-hub"
+INSTALL_DIR="${KIMI_MCP_HUB_DIR:-$HOME/.kimi-mcp-hub}"
+BIN_DIR="${KIMI_MCP_HUB_BIN:-$HOME/.local/bin}"
+
+# Colors
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+CYAN='\033[0;36m'
+DIM='\033[0;90m'
+NC='\033[0m'
+
+print_header() {
+    echo ""
+    echo -e "${CYAN}  KIMI MCP HUB${NC} - One-click MCP server & skills manager"
+    echo -e "${DIM}  23 MCP Servers | 34 AI Skills | Persistent Memory${NC}"
+    echo ""
+}
+
+print_success() {
+    echo -e "${GREEN}✓${NC} $1"
+}
+
+print_info() {
+    echo -e "${CYAN}→${NC} $1"
+}
+
+print_warning() {
+    echo -e "${YELLOW}⚠${NC} $1"
+}
+
+print_error() {
+    echo -e "${RED}✗${NC} $1"
+}
+
+check_requirements() {
+    print_info "Checking requirements..."
+    
+    # Check Python
+    if command -v python3 &>/dev/null; then
+        PYTHON="python3"
+    elif command -v python &>/dev/null; then
+        PYTHON="python"
+    else
+        print_error "Python 3.10+ is required but not found."
+        echo "   Install from: https://python.org/downloads"
+        exit 1
+    fi
+    
+    PYTHON_VERSION=$($PYTHON --version 2>&1 | cut -d' ' -f2)
+    print_success "Python $PYTHON_VERSION found"
+    
+    # Check pip
+    if ! $PYTHON -m pip --version &>/dev/null 2>&1; then
+        print_error "pip is required but not found."
+        echo "   Install: $PYTHON -m ensurepip --upgrade"
+        exit 1
+    fi
+    print_success "pip found"
+    
+    # Check Node.js (optional, for MCP servers)
+    if command -v node &>/dev/null; then
+        NODE_VERSION=$(node --version 2>/dev/null || echo "?")
+        print_success "Node.js $NODE_VERSION found (for MCP servers)"
+    else
+        print_warning "Node.js not found (needed for some MCP servers)"
+        echo "   Install from: https://nodejs.org"
+    fi
+    
+    # Check npx (optional)
+    if command -v npx &>/dev/null; then
+        print_success "npx found"
+    else
+        print_warning "npx not found (needed for some MCP servers)"
+    fi
+}
+
+detect_shell() {
+    case "$(basename "$SHELL")" in
+        bash) echo "bash" ;;
+        zsh)  echo "zsh"  ;;
+        fish) echo "fish" ;;
+        *)    echo "unknown" ;;
+    esac
+}
+
+add_to_path() {
+    local shell_rc=""
+    local shell_name=$(detect_shell)
+    
+    case "$shell_name" in
+        bash) shell_rc="$HOME/.bashrc" ;;
+        zsh)  shell_rc="$HOME/.zshrc" ;;
+        fish) shell_rc="$HOME/.config/fish/config.fish" ;;
+        *)    shell_rc="$HOME/.profile" ;;
+    esac
+    
+    # Check if already in PATH
+    if [[ ":$PATH:" == *":$BIN_DIR:"* ]]; then
+        return 0
+    fi
+    
+    if [ -f "$shell_rc" ]; then
+        echo "" >> "$shell_rc"
+        echo "# Added by Kimi MCP Hub installer" >> "$shell_rc"
+        if [ "$shell_name" = "fish" ]; then
+            echo "set -x PATH $BIN_DIR \$PATH" >> "$shell_rc"
+        else
+            echo "export PATH=\"$BIN_DIR:\$PATH\"" >> "$shell_rc"
+        fi
+        print_info "Added $BIN_DIR to PATH in $shell_rc"
+        print_warning "Run: source $shell_rc  (or restart your terminal)"
+    fi
+}
+
+install_from_pypi() {
+    print_info "Installing kimi-mcp-hub from PyPI..."
+    $PYTHON -m pip install --upgrade --user kimi-mcp-hub
+    print_success "Installed from PyPI"
+}
+
+install_from_github() {
+    print_info "Cloning repository..."
+    
+    # Remove old install if exists
+    if [ -d "$INSTALL_DIR" ]; then
+        rm -rf "$INSTALL_DIR"
+    fi
+    
+    git clone --depth 1 "https://github.com/$REPO.git" "$INSTALL_DIR"
+    print_success "Cloned to $INSTALL_DIR"
+    
+    print_info "Installing package..."
+    cd "$INSTALL_DIR"
+    $PYTHON -m pip install --upgrade --user -e .
+    print_success "Package installed"
+}
+
+install_pip_git() {
+    print_info "Installing directly from GitHub (pip)..."
+    $PYTHON -m pip install --upgrade --user "git+https://github.com/$REPO.git"
+    print_success "Installed from GitHub"
+}
+
+post_install() {
+    print_info "Running post-install setup..."
+    
+    # Ensure bin directory exists
+    mkdir -p "$BIN_DIR"
+    
+    # Check if kimi-mcp-hub is in PATH
+    if ! command -v kimi-mcp-hub &>/dev/null; then
+        # Try to find the installed script
+        USER_BASE=$($PYTHON -m site --user-base 2>/dev/null || echo "$HOME/.local")
+        SCRIPT_DIR="$USER_BASE/bin"
+        
+        if [ -f "$SCRIPT_DIR/kimi-mcp-hub" ]; then
+            print_info "Found kimi-mcp-hub at $SCRIPT_DIR"
+            add_to_path
+        fi
+    fi
+    
+    # Create ~/.kimi directory
+    mkdir -p "$HOME/.kimi"
+    
+    print_success "Setup complete"
+}
+
+show_welcome() {
+    echo ""
+    echo -e "${GREEN}╔══════════════════════════════════════════════════════════╗${NC}"
+    echo -e "${GREEN}║${NC}  ${CYAN}Kimi MCP Hub${NC} installed successfully!                ${GREEN}║${NC}"
+    echo -e "${GREEN}╚══════════════════════════════════════════════════════════╝${NC}"
+    echo ""
+    echo -e "${CYAN}Quick start:${NC}"
+    echo "  kimi-mcp-hub init      # Run interactive setup wizard"
+    echo "  kimi-mcp-hub status    # Check installation status"
+    echo "  kimi-mcp-hub welcome   # Show welcome banner"
+    echo "  kimi-mcp-hub doctor    # Check system health"
+    echo ""
+    echo -e "${CYAN}Add your first server:${NC}"
+    echo "  kimi-mcp-hub add github"
+    echo "  kimi-mcp-hub auth github  # Auto-browser OAuth"
+    echo ""
+    echo -e "${CYAN}Use in Kimi CLI:${NC}"
+    echo "  /mcp       # List available tools"
+    echo "  /skills    # List installed skills"
+    echo ""
+    echo -e "${DIM}Need help? Run: kimi-mcp-hub --help${NC}"
+    echo ""
+}
+
+main() {
+    print_header
+    check_requirements
+    
+    # Parse arguments
+    METHOD="${1:-auto}"
+    
+    case "$METHOD" in
+        --pip|pip)
+            install_pip_git
+            ;;
+        --clone|clone)
+            install_from_github
+            ;;
+        --pypi|pypi)
+            install_from_pypi
+            ;;
+        *)
+            # Try PyPI first, fallback to pip+git
+            if $PYTHON -m pip install --dry-run kimi-mcp-hub &>/dev/null 2>&1; then
+                install_from_pypi
+            else
+                print_info "PyPI package not found, installing from GitHub..."
+                install_pip_git
+            fi
+            ;;
+    esac
+    
+    post_install
+    show_welcome
+}
+
+main "$@"

package/install/npm-wrapper.js

@@ -0,0 +1,156 @@
+#!/usr/bin/env node
+"use strict";
+
+const { spawnSync } = require("child_process");
+const process = require("process");
+const fs = require("fs");
+const path = require("path");
+const os = require("os");
+
+const REPO = "KalimeroMK/kimi-mcp-hub";
+const PYPI_NAME = "kimi-mcp-hub";
+const PYTHON_MODULE = "kimi_mcp_hub";
+const INSTALL_DIR = path.join(os.homedir(), ".kimi-mcp-hub");
+const VENV_DIR = process.env.KIMI_MCP_HUB_VENV || path.join(INSTALL_DIR, "venv");
+const LOCAL_REPO_DIR = path.resolve(path.join(__dirname, ".."));
+
+function log(...args) {
+  console.log("[kimi-mcp-hub]", ...args);
+}
+
+function error(...args) {
+  console.error("[kimi-mcp-hub]", ...args);
+}
+
+function getPythonVersion(cmd) {
+  const result = spawnSync(cmd, ["--version"], { stdio: "pipe", shell: false });
+  if (result.status !== 0) return null;
+  const match = String(result.stdout || result.stderr).match(/(\d+)\.(\d+)/);
+  if (!match) return null;
+  return { major: parseInt(match[1], 10), minor: parseInt(match[2], 10) };
+}
+
+function findPython() {
+  for (const cmd of ["python3.13", "python3.12", "python3.11", "python3.10", "python3", "python"]) {
+    const version = getPythonVersion(cmd);
+    if (version && version.major === 3 && version.minor >= 10) return cmd;
+  }
+  return null;
+}
+
+function venvPython() {
+  return process.platform === "win32"
+    ? path.join(VENV_DIR, "Scripts", "python.exe")
+    : path.join(VENV_DIR, "bin", "python");
+}
+
+function run(cmd, args, options = {}) {
+  const result = spawnSync(cmd, args, {
+    stdio: "inherit",
+    shell: false,
+    ...options,
+  });
+  return result.status ?? 1;
+}
+
+function moduleAvailable(python) {
+  const result = spawnSync(
+    python,
+    ["-c", `import ${PYTHON_MODULE}; print(${PYTHON_MODULE}.__version__)`],
+    { stdio: "pipe", shell: false }
+  );
+  return result.status === 0;
+}
+
+function isLocalRepo() {
+  return (
+    fs.existsSync(path.join(LOCAL_REPO_DIR, "pyproject.toml")) &&
+    fs.existsSync(path.join(LOCAL_REPO_DIR, "src", PYTHON_MODULE))
+  );
+}
+
+function getInstallSpec() {
+  if (isLocalRepo()) {
+    log("Using local repository at", LOCAL_REPO_DIR);
+    return LOCAL_REPO_DIR;
+  }
+  return `git+https://github.com/${REPO}.git`;
+}
+
+function ensureVenv(python) {
+  if (fs.existsSync(venvPython())) {
+    return;
+  }
+  log("Creating isolated Python environment...");
+  fs.mkdirSync(INSTALL_DIR, { recursive: true });
+  const createResult = run(python, ["-m", "venv", VENV_DIR]);
+  if (createResult !== 0) {
+    error("Failed to create virtual environment.");
+    process.exit(1);
+  }
+}
+
+function installPackage(python) {
+  ensureVenv(python);
+  const venvPy = venvPython();
+
+  log("Installing Kimi MCP Hub...");
+
+  // Upgrade pip first to avoid build issues.
+  run(venvPy, ["-m", "pip", "install", "--upgrade", "pip"]);
+
+  const installSpec = getInstallSpec();
+
+  // Prefer PyPI when the package is published and not running from a local repo.
+  let installArgs;
+  if (installSpec === LOCAL_REPO_DIR) {
+    installArgs = ["-m", "pip", "install", "--upgrade", installSpec];
+  } else {
+    const pypiDry = spawnSync(
+      venvPy,
+      ["-m", "pip", "install", "--dry-run", PYPI_NAME],
+      { stdio: "pipe", shell: false }
+    );
+    installArgs =
+      pypiDry.status === 0
+        ? ["-m", "pip", "install", "--upgrade", PYPI_NAME]
+        : ["-m", "pip", "install", "--upgrade", installSpec];
+  }
+
+  const installResult = run(venvPy, installArgs);
+  if (installResult !== 0) {
+    error("Failed to install the Python package.");
+    process.exit(1);
+  }
+  log("Kimi MCP Hub installed.");
+}
+
+function main() {
+  const args = process.argv.slice(2);
+  const command = args[0];
+
+  const python = findPython();
+  if (!python) {
+    error("Python 3.10+ is required but not found. Install it from https://python.org/downloads");
+    process.exit(1);
+  }
+
+  const venvPy = venvPython();
+
+  if (command === "install" || command === undefined) {
+    installPackage(python);
+    log("Running interactive setup...");
+    const initResult = run(venvPy, ["-m", PYTHON_MODULE, "init"]);
+    process.exit(initResult);
+  }
+
+  if (!moduleAvailable(venvPy)) {
+    log("Kimi MCP Hub not found. Installing first...");
+    installPackage(python);
+  }
+
+  const result = run(venvPy, ["-m", PYTHON_MODULE, ...args]);
+  process.exit(result);
+}
+
+main();

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "kimi-mcp-hub",
+  "version": "0.1.0",
+  "description": "One-click MCP server and skills manager for Kimi CLI",
+  "main": "install/npm-wrapper.js",
+  "bin": {
+    "kimi-mcp-hub": "install/npm-wrapper.js"
+  },
+  "files": [
+    "install/",
+    "README.md"
+  ],
+  "scripts": {
+    "test": "echo 'Run Python tests: python -m pytest'"
+  },
+  "keywords": [
+    "kimi",
+    "mcp",
+    "cli",
+    "installer"
+  ],
+  "author": "KalimeroMK",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/KalimeroMK/kimi-mcp-hub.git"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}